Markdown 语法支持自己编写目录，但是碰到中文标题就捉襟见肘了。不久前在写项目 README 的时候，我一时兴起准备给文章编写一个目录，却发现一开始编写的目录竟然可以自动更新。照着目录的格式摸索了几次，终于总结出快速编写目录的方法。

可自动更新目录需要在 VS Code 中安装插件 Markdown All in One。

以本文为例，编写可自动更新的目录的步骤如下：

步骤 1

创建 Markdown 文件后，先输入一个标题。如：
# VS Code笔记之快速插入Markdown目录

步骤 2

在需要创建目录的地方输入 - [](#注意空格和英文半角括号，这时会有自动补全列表弹出，选择”VS Code 笔记之快速插入 Markdown 目录” 的标题，如图 1。

图1

图 1

选择标题后，目录的最上方会有灰色的小字 Table of Contents (up to date)，效果如图 2 所示。

图2

图 2

此时，插件就已经把这一块列表识别为文章的目录了。对于已经创建的 Markdown 文档，在步骤 2 输入列表时，有时需要输入两级标题才可以被插件识别为目录。

步骤 3

保存文件，插件会自动补全连接的内容，见图 3 所示。之后，插件就会在保存文件时自动获取文章的各级标题，并添加到目录列表中。

图3

图 3

如果这篇可自动更新的 Markdown 目录编写指南对你有帮助，请别忘了一键三连收藏分享哦。