自动摘要: 在使用Markdown写文档时,有时需要给单个文档生成目录,比如包含多个问题的FAQ(FrequentlyAskedQuestions)文档。 **1.下载和安装Vis ……..
在使用 Markdown 写文档时,有时需要给单个文档生成目录,比如包含多个问题的 FAQ (Frequently Asked Questions) 文档。
1. 下载和安装 Visual Studio Code。
2. 单击 VS Code 的扩展图标,在搜索框搜索 **Auto Markdown TOC**
并安装。
安装成功后,点击左侧扩展图标,可查看已安装的扩展。如下图所示:
3. 点击菜单栏的**文件**
-> **打开**
,打开需要生成目录的 .md 格式的文件。
以如下 FAQ.md 文件为例:
在 MacDown 中的显示
FAQ.md 在 VS Code 中打开后显示如下:
4. 将光标移至需要插入目录的位置,右键单击 **Markdown TOC: Insert/Update [^M T]**
,目录即自动插入。
显示效果如下:
5. 单击右上角的预览图标,可查看目录的显示效果。
预览图标
显示效果如下:
注:为保持文档整洁,删除目录首尾的如下字符:
1 | <!-- TOC --> |
6. 保存,关闭文件。