Azure DevOps Wiki：如何在页面内部进行链接？

Question

在我的DevOps Wiki上，我有一个页面，并想创建一个索引，包括指向文章的链接。 主要是我发现这个手册可以做到这一点：learn.microsoft.com... 但我无法让它工作。

如何在Wiki页面内部进行链接？你能给出一个例子吗？

我猜我必须设置一个锚点到标题，然后将索引项链接到锚点？！

这里是一个例子：

Index
1.First article
2.Second article

#1.First article
bla bla bla ...

#2.Second article
bla bla bla ...
and a image

- Frank Mehlhop

Answer 1

我猜您可能遇到了一些术语问题。关于“我有一个页面，想创建一个包括链接到文章的索引”：

1. 通常情况下，“页面”和“文章”是同义词。据我所知，当您说“文章”时，您指的是同一页面/文章的子部分。页面/文章的子部分由您和您使用的标题来区分。
2. 当您说“索引”时，我想您指的是目录（TOC）提供的结果。如果您想要比TOC提供更多的控制权，您可以构建自己的“索引”，链接到您选择的标题，例如这个示例页面：

# My Index
1. [First Index Item, H1](#heading1).
1. [Second Index Item, H2.1](#heading2.1).
1. [Third Index Item, H4](#heading4).

# Heading1
Add a bunch of filler here to space out the page so you can see the result of selecting your '_Index_" items ([My Index](#my-index) above).

# Heading2
Add a bunch of filler here to space out the page.

## Heading2.1
Add a bunch of filler here to space out the page.

# Heading3
Add a bunch of filler here to space out the page.

# Heading4
Add a bunch of filler here to space out the page.

- ScottWelker

---

谢谢。我想补充一下，它可以很好地处理单个单词，但是当链接的标题之间有空格时（例如“＃我的标题”），它就无法正常工作了。或者我无法弄清如何使用带有空格的标题。 - Frank Mehlhop

没错。出于这个原因，我在我的示例中避免使用空格。但是，在Azure DevOps Wiki中，你只需用破折号“-”代替空格即可。例如，对于你的makrdown #My header，链接为'#my-header'。 - ScottWelker

我还应该注意到，在链接文本中使用全部小写最好。混合大小写有时可以正常工作，但并非总是如此。不确定为什么。此外，我养成了在标题的最后一个井号和其文本之间始终包括一个空格的习惯，例如 # My headaer 而不是 #My header。在 Azure DevOps Wiki 中似乎无关紧要。然而，其他 Wiki 引擎可能更加挑剔（CommonMark 规范 似乎要求这样做）。如果您将内容移植到另一个引擎中，这可能会带来麻烦。 - ScottWelker

还要注意，您可以检索到任何标题的链接。在查看页面时（不是在编辑模式下），将鼠标放在要链接的标题所在的同一行上。一个代表两个链条链接的图标将出现在您的标题右侧。单击它，您的浏览器的URL将包括完整的链接，以“?anchor=<your header link>”结尾。将其转换为“#<your header link>”，您就可以在Wiki页面中使用它来导航到特定页面的标题部分。 - ScottWelker

如果你有一个像6. Header 6这样的点，你必须转义这个点，所以结果是(#6\.-header-6)。 - undefined

Answer 2

这里是语法的一个例子：

- [Article1](/Articles/Aricle1)

括号中写着相对于该Wiki页面的文章路径。

- Che

---

这样我可以链接一个页面，但不能链接同一页内的文章或标题。 - Frank Mehlhop