跳转到主内容
新派编程网 - 新潮编程理念,全新技术课堂!

在VSCode中为Markdown自动生成目录

在 VSCode 中为 Markdown 自动生成目录,最简单有效的方式是安装 Markdown All in One 插件,通过快捷键 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(Mac)执行“Markdown: Create Table of Contents”命令,支持自动更新、深度控制及中文锚点。

在vscode中为markdown自动生成目录,最简单有效的方式是安装插件并配合快捷键操作,无需手动编写或复制粘贴。

推荐插件:Markdown All in One这是目前 VSCode 中最主流、功能最全的 Markdown 插件,支持一键生成/更新目录(Table of Contents),且能自动识别标题层级(#到######)。

在扩展市场搜索Markdown All in One,安装并重启 VSCode(通常无需重启)

打开任意.md文件,确保文档中有至少两个标题(如# 简介、## 安装步骤)

将光标放在你希望插入目录的位置(例如文件开头或“目录”标题下方)

按下快捷键:

Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(Mac),输入Markdown: Create Table of Contents并回车让目录自动更新更省心默认情况下,目录不会实时同步标题变更。但你可以开启自动更新,减少手动干预:打开 VSCode 设置(Ctrl+,),搜索markdown.extension.toc.autoUpdate勾选该选项,保存后每次保存文件时,已存在的目录会自动刷新也可通过命令面板运行Markdown: Update Table of Contents手动刷新(适合未启用自动更新时)

自定义目录样式和行为插件支持灵活配置,比如跳过某级标题、使用括号链接、限制最大深度等:elasticsearch-9.4.0 win PHP中文网提供Elasticsearch 9.4.0 Windows 版本压缩包下载解压即用,内置 OpenJDK 无需额外配置 Java 环境。该版本重磅推出原生 Prometheus 支持、正式版 Elastic Workflows 以及基于 NVIDIA cuVS 的 GPU 加速向量索引,大幅提升 AI 检索与可观测性能力。建议前往官网下载,快速体验极速搜索与强大的数据分析功能。

下载在设置中搜索markdown.extension.toc

,可调整:

depth(默认 6,设为 3 就只显示 #~###)、includeLevel(指定包含哪些层级)、slugifyMode(控制锚点生成规则)

若想目录用括号语法(如[简介](#简介))而非默认的自动锚点,启用markdown.extension.toc.useGithubStyle中文标题默认能正确生成锚点,无需额外处理(插件已内置兼容)

基本上就这些。不需要写脚本、不依赖外部工具,装一个插件 + 一次快捷键,就能获得结构清晰、点击跳转的目录。对日常写文档、写笔记、维护 README 来说,非常顺手。

相关文章