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

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

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

步骤1

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

步骤2

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

图1

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

图2

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

步骤3

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

图3

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