如何在 Markdown 文件中设置锚点

Question

我想在 .md 文件中设置锚点。该文件位于 Team Foundation Server 中，但标签

<a name="anchor"></a>

不起作用。是否有其他可能性在 .md 文件中设置锚点？

我已经尝试过以下方法：

链接到锚点

[Question 22](answers.md#answer22)

设置锚点

<a name="answer22"></a> This is an answer for Question 22

结果是，点击“问题 22”，文件answers.md 成功打开，但没有“跳转”到问题 22。此外，标签

<a name="answer22"><a/>

似乎没有被识别为 md 中的代码。文件存储在 TFS 中。如果我打开文件answer22.md并查看预览（在TFS中，您可以在“内容”、“预览”、“历史记录”等之间切换），则标签不会隐藏，您可以在预览中看到它，就好像它一样只是纯文本。

Answer 1

如Microsoft 基本 Markdown 指南中所述，为每个标题生成锚点。

只需将您的答案放在标题下方即可。

问题.md

[Question22](./answers.md#answer-22)

answers.md

## Answer 22

The answer is 42

Answer 2

常见的 Markdown 交叉引用

请参阅 Markdown 指南，扩展语法：链接到标题 ID。

此次降价：

[Heading ID](#heading-id)   

大多数受支持的引擎应将其呈现为以下 HTML 链接：

<a href="#heading-id">Heading ID</a>    

这可能再次引用名为

heading-id

的页面片段（锚点），无论是在同一页面内，还是在其他页面上（

/other-page#heading-id

）或同一命名空间/文件夹中的文件（由

./other-file.md/#heading-id

表示）。

TFS 支持

来自文档TFS 2018：基本 Markdown 指南，锚链接：

您还可以引用另一个 Markdown 文件中的标题：

[text to display](./target.md#heading-id)

在 wiki 中，您还可以引用另一个页面中的标题：

[text to display](/page-name#section-name)

要引用其他 Markdown 文件或 wiki 页面，重要的是要知道如何从标题中分配锚点名称（此处为

heading-id

或

section-name

）：slug。

从标题到标题

标题的文本用作 slug 形式的锚点名称。 Slug 是通过遵循以下规则从任何文本生成的：

• 标点符号和前导空格（也在文件名内）将被忽略
• 全部小写
• 一个或多个连续空格转换为单个连字符

另请参阅

• 类似问题Anchor 找不到标题，由 TFS 金徽章装饰的 PatrickLu-MSFT 回答。
• Microsoft 开发者社区，Azure DevOps Server (TFS)，搜索“anchor”

Answer 3

在 Pandoc Markdown 中，您可以使用语法

[span]{#anchor}

在段落内的任意跨度上设置锚点，例如：

[This is an answer for question 22]{#answer-22}

然后照常引用它：

[Question 22](#answer-22)

。

如果你想引用整个段落，那么从形式上来说这是不可能的，但你可以做一个简单的修改，在段落的开头添加一个empty跨度：

[]{#answer-22}
Paragraph text.