MultiMarkdown 4.7有一个{{TOC}}宏，用于插入一个目录表。

对于Visual Studio Code用户来说，今天(2020年)使用的最佳选择是Markdown All in One插件(扩展)。

要安装它，启动VS Code快速打开(Control/⌘+P)，粘贴以下命令，并按enter。

ext install yzhang.markdown-all-in-one

要生成TOC，打开命令面板(Control/⌘+Shift+P)，并选择select Markdown:创建内容表选项。

---

另一个选择是Markdown TOC插件。

要安装它，启动VS Code快速打开(Control/⌘+P)，粘贴以下命令，并按enter。

ext install markdown-toc

要生成TOC，打开命令面板(Control/⌘+Shift+P)，并选择Markdown TOC:插入/更新选项或使用Control/⌘+MT。

有两种方法可以在你的降价文档中创建你的TOC(摘要)。

1. 手动

# My Table of content
- [Section 1](#id-section1)
- [Section 2](#id-section2)

<div id='id-section1'/>
## Section 1
<div id='id-section2'/>
## Section 2

2. 以编程方式

例如，你可以使用一个脚本，为你生成摘要，看看我的项目在github - summarizeMD -

我也尝试过其他脚本/npm模块(例如doctoc)，但没有人用工作锚重现TOC。

对我来说，@Tum提出的解决方案对于2个层次的目录来说非常有效。然而，对于第3个关卡，这种方法却不起作用。它没有像前两层那样显示链接，而是显示纯文本3.5.1。[bla blabla](#blablabla) <br>代替。

我的解决方案是@Tum解决方案(非常简单)的补充，适用于需要3级或以上目录的人。

在第二层，一个简单的制表符将为您正确地完成缩进。但它不支持2个标签。相反，你必须使用一个标签，并添加尽可能多的&nbsp;根据你自己的需要来正确对齐第三层。

下面是一个使用4个关卡的例子(关卡越高，它就变得越糟糕):

# Table of Contents
1. [Title](#title) <br>
    1.1. [sub-title](#sub_title) <br>
    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;1.1.1. [sub-sub-title](#sub_sub_title)
    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;1.1.1.1. [sub-sub-sub-title](#sub_sub_sub_title)

# Title <a name="title"></a>
Heading 1

## Sub-Title <a name="sub_title"></a>
Heading 2

### Sub-Sub-Title <a name="sub_sub_title"></a>
Heading 3

#### Sub-Sub-Sub-Title <a name="sub_sub_sub_title"></a>
Heading 4

这将给出以下结果，其中目录表的每个元素都是到其相应部分的链接。还要注意<br>，以便添加新行，而不是在同一行上。

目录

标题 1.1. 字幕 1.1.1。Sub-Sub-Title                   1.1.1.1。Sub-Sub-Sub-Title

标题

标题1

字幕

标题2

Sub-Sub-Title

标题3

Sub-Sub-Sub-Title

标题4

这是一个简短的PHP代码，我用来生成TOC，并丰富任何标题与锚:

$toc = []; //initialize the toc to an empty array
$markdown = "... your mardown content here...";

$markdown = preg_replace_callback("/(#+)\s*([^\n]+)/",function($matches) use (&$toc){
    static $section = [];
    $h = strlen($matches[1]);

    @$section[$h-1]++;
    $i = $h;
    while(isset($section[$i])) unset($section[$i++]);

    $anchor = preg_replace('/\s+/','-', strtolower(trim($matches[2])));

    $toc[] = str_repeat('  ',$h-1)."* [".implode('.',$section).". {$matches[2]}](#$anchor)";
    return str_repeat('#',$h)." <strong>".implode('.',$section).".</strong> ".$matches[2]."\n<a name=\"$anchor\"></a>\n";
}, $markdown);

然后你可以打印经过处理的markdown和toc:

   print(implode("\n",$toc));
   print("\n\n");
   print($markdown);

我写了一个python脚本，解析一个降价文件，并输出一个目录作为降价列表:md-to-toc

与我发现的其他脚本不同，md-to-toc正确地支持重复的标题。它也不需要互联网连接，所以它可以在任何md文件，而不仅仅是从公共回购。