Markdown 中的交叉引用（命名锚点）

Question

是否有相当于以下内容的 降价 语法：

 Take me to <a href="#pookie">pookie</a>

...

<a name="pookie">this is pookie</a>

原文由 Synesso 发布，翻译遵循 CC BY-SA 4.0 许可协议

Answer 1

Take me to [pookie](#pookie)

应该是跳转到名为 pookie 的锚点的正确降价语法。

要插入该名称的锚点，请使用 HTML：

 <a name="pookie"></a>

Markdown 似乎不介意你把锚点放在哪里。一个有用的地方是在标题中。例如：

 ### <a name="tith"></a>This is the Heading

效果很好。 （我会在这里演示，但是 SO 的渲染器去掉了锚点。）

关于自闭标签和 id= 与 name= 的注意事项

这篇文章的早期版本建议使用 <a id='tith' /> ，使用 XHTML 的自关闭语法，并使用 id 属性而不是 name .

XHTML 允许任何标记为“空”和“自闭”。也就是说， <tag /> 是 <tag></tag> 的简写，是一对匹配的标签，主体为空。大多数浏览器将接受 XHTML，但有些浏览器不接受。为避免跨浏览器问题，请按照上面的建议使用 <tag></tag> 显式关闭标签。

最后，属性 name= 在 XHTML 中被弃用，所以我最初使用 id= ，这是每个人都认可的。但是，HTML5 现在在使用 id= 时会在 JavaScript 中创建一个全局变量，而这不一定是您想要的。因此，使用 name= 现在可能更友好。

（感谢 Slipp Douglas 向我解释了 XHTML，感谢 nailer 指出了 HTML5 的副作用——请参阅评论和 nailer 的 回答 以获得更多详细信息 name= 似乎无处不在，尽管它已被弃用在 XHTML 中。）

原文由 Steve Powell 发布，翻译遵循 CC BY-SA 3.0 许可协议

Answer 2

在 bitbucket.org 上，投票的解决方案不起作用。相反，当使用标头（带有##）时，可以通过将它们作为前缀作为#markdown-header-my-header-name 将它们引用为锚点，其中#markdown-header- 是由渲染器生成的隐式前缀，并且其余的是用破折号代替空格的小写标题标题。

例子

## My paragraph title

会产生一个像这样的隐式锚点

#markdown-header-my-paragraph-title

每个锚引用之前的整个 URL 是可选的，即

[Some text](#markdown-header-my-paragraph-title)

相当于

[Some text](https://bitbucket.org/some_project/some_page#markdown-header-my-paragraph-title)

前提是它们在同一页面中。

来源： https ://bitbucket.org/tutorials/markdowndemo/overview（编辑此 .md 文件的来源并查看锚点的制作方式）。

原文由 La Muerte Peluda 发布，翻译遵循 CC BY-SA 3.0 许可协议