如何在 GitLab wiki 中创建目录？答案

【问题标题】：How can I create a table of content in GitLab wiki?如何在 GitLab wiki 中创建目录？
【发布时间】：2018-04-19 15:52:59
【问题描述】：

我是__TOC__ 的忠实粉丝，它在维基媒体页面上创建目录。

每当您在维基媒体页面上写下这样的内容时：

This is a page for my project

## Credits ##

bla bla

## License ##

bla bla

__TOC_ 自动创建一个目录，让您可以浏览页面的内部链接。

我注意到这在 GitHub wiki 页面中是可能的：How do I create some kind of table of content in GitHub wiki? 通过使用不同的技巧。

但是，我想念 GitLab wiki 页面中的这个功能。它提供这样的功能吗？

【问题讨论】：

【解决方案1】：

所以这存在！我终于在 GitLab 社区版中找到了一个合并请求：Replace Gollum [[_TOC_]] tag with result of TableOfContentsFilter

正如它的名字所描述的，要拥有一个目录，您需要编写以下内容：

[[_TOC_]]

大家可以这样写：

This is a page for my project

[[_TOC_]]

## Credits

bla bla

## License

bla bla

会像这样显示：

这可以从GitLab 8.6 release 获得，如its milestone 中所述。

【讨论】：

【解决方案2】：

应该是这样的

 ##### Table of Contents  
[1.-First Topic](#first-topic)
[2.-Second Topic](#second-topic) 
[3.-Third Topic](#third_topic)

然后您将在同一页面上通过使用来引用每个

 <a name="first-topic"/>
 <a name="second-topic"/>
 <a name="third-topic"/>

【讨论】：

【解决方案3】：

尝试在文档顶部使用{{< toc >}}。它应该会自动为您生成 TOC。

【讨论】：