【问题标题】:What's the best way to create fragment anchors in GitHub markdown?在 GitHub markdown 中创建片段锚点的最佳方法是什么?
【发布时间】:2020-05-28 15:05:20
【问题描述】:

我正在尝试创建片段锚以用于 GitHub 降价中的链接目标。我试图避免嵌入 HTML 元素,因为最佳实践 Markdown 是避免内联 HTML。

我不是在谈论标题锚点(尽管如果标题包含非字母字符,那么让自动生成的标题链接正常工作可能会让人头疼)。我需要为 .md 文件中的任意位置设置锚点。

我遇到了link reference definitions 的 GitHub 文档,但该文档并没有真正清楚地解释如何创建锚点。我尝试按照Example 168 创建链接引用而不指定目标,但这不会创建锚点;可以这么说,它只是创造了一条“无路可走”。

最好的选择是什么?

【问题讨论】:

  • 您必须使用 HTML。只有标题才能为您提供一种自动生成锚点的降价方式。

标签: markdown github-flavored-markdown


【解决方案1】:

Markdown 不支持开箱即用的自定义锚点(但是,某些 Markdown 风格可能支持),因此您必须使用 HTML。

创建一个锚点:

<a name="location"></a>

参考这个锚点:

Take me to something [custom](#location)

【讨论】:

  • 这就是答案很烦人:-(
猜你喜欢
  • 1970-01-01
  • 2011-03-18
  • 2017-08-06
  • 1970-01-01
  • 1970-01-01
  • 2022-01-05
  • 2017-04-13
  • 1970-01-01
  • 1970-01-01
相关资源
最近更新 更多