在 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 手动刷新（适合未启用自动更新时）
自定义目录样式和行为
插件支持灵活配置，比如跳过某级标题、使用括号链接、限制最大深度等：
- 在设置中搜索 markdown.extension.toc，可调整：depth（默认 6，设为 3 就只显示 #～###）、includeLevel（指定包含哪些层级）、slugifyMode（控制锚点生成规则）
- 若想目录用括号语法（如 [简介](#简介)）而非默认的自动锚点，启用 markdown.extension.toc.useGithubStyle
- 中文标题默认能正确生成锚点，无需额外处理（插件已内置兼容）
基本上就这些。不需要写脚本、不依赖外部工具，装一个插件 + 一次快捷键，就能获得结构清晰、点击跳转的目录。对日常写文档、写笔记、维护 README 来说，非常顺手。
