Markdown 文件内链接未转换

问题描述 投票:0回答:2

我正在使用 Markdown 和 Jekyll 设置和配置我的第一组 Github 页面。我的所有内容都已转换为 Markdown,生成的网页的基本外观和感觉是正确的,但存在一些重大问题。例如,Markdown 表示同文件内链接应该类似于 Markdown 中的

[Link Name](#headername)
,但这些仅在我的 html 输出中显示为文字文本。例如这一行:

For more information, see [More About Arrays](#More About Arrays)

显示完全相同(带方括号、圆括号等)。

[Link Name](some_url)
形式的链接确实有效。

这是我的

_config.yml

name: RTcmix
markdown: GFM
kramdown:
    syntax_highlighter: rouge
    input: GFM

这个 Github-pages 站点是我的,尚未被任何人引用,因此我通过将更改直接推送到 master 并等待一段时间,然后查看来进行测试。我有经过验证的电子邮件,但没有收到任何错误报告。

markdown jekyll github-pages
2个回答
0
投票

https://www.markdownguide.org/basic-syntax/#links

Markdown 应用程序对于如何处理 URL 中间的空格并不一致。为了兼容性,请尝试使用 %20 对任何空格进行 URL 编码。或者,如果您的 Markdown 应用程序支持 HTML,您可以使用

a
HTML 标签。

示例说要这样做:

[link](https://www.example.com/my%20great%20page)

<a href="https://www.example.com/my great page">link</a>

所以你的代码应该是这样的markdown

[More About Arrays](#More%20About%20Arrays)

或者简单地

<a href="#More About Arrays">More About Arrays</a>

0
投票

感谢 Adrian 提供的空间格式帮助。我通过反复试验并查看“Macdown”应用程序的帮助文件中的单个示例,得出了以下结论。

一个可行的解决方案是:

  1. 链接的目标应采用以下形式并带有“名称”标签:
### <a name="more-about-arrays"></a>More About Arrays
  1. 其内部链接应采用以下示例所示的形式:
For more information, see [More About Arrays](#more-about-arrays) below.

此外,通过使用不带空格的“名称”,我不再需要“%20”格式,因为可见名称不用于导航并且可以保持未格式化。

© www.soinside.com 2019 - 2024. All rights reserved.