在 GitHub markdown 中创建片段锚点的最佳方法是什么?

What's the best way to create fragment anchors in GitHub markdown?

我正在尝试创建片段锚点以用于 GitHub markdown 中的 link 目的地。我试图避免嵌入 HTML 元素,因为 best-practice markdown 是为了避免内联 HTML.

我不是在谈论标题锚点(尽管如果标题有 non-letter 个字符,让 auto-generated 个标题 link 起作用可能会 trial-and-error 头疼).我需要在 .md 文件中的任意位置设置锚点。

我发现 GitHub 文档 link reference definitions, but that documentation doesn't really explain clearly how to create an anchor. I tried following Example 168 没有指定目的地就创建了 link 引用,但这并没有创建锚点;它只是创建了一个 "road to nowhere",可以这么说。

最好的选择是什么?

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

创建锚点:

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

参考这个锚点:

Take me to something [custom](#location)