# Markdown 文章自动生成目录

本文主要讲解 Markdown 文章在 Vuepress 项目中的展示。

第一种方式很简单，在文章首页加入 toc 标记，启动服务后，便可看到当前文章的目录。

[[toc]]

第二种方式就是使用 VSCode 的插件 Markdown all in one。

在 VSCode 中插件搜索到该插件后，进行下载安装。

然后使用 Command + Shift + P 唤起万能搜索，搜索 markdown，将会出现如下提示，选择 Markdown All in One: Create Table of Contents。

注意：在选择之前，光标位置应该在当前 md 文件的头部位置。

生成之后的大概是下图这样，目录会随着标题的改动自动更新。

标题最好不要使用特殊字符，会出现无法跳转的情况。