vscode 通过 markdown all in one 插件可动态生成兼容 github 的 markdown 目录：基于真实标题实时扫描、自动更新锚点、支持六级标题、离线可用；命令仅在光标处插入无序列表 toc，优先使用 {#custom-id}，需规避反引号等非法字符导致的锚点错误。
VSCode 本身不提供“目录模板”功能，但通过插件 + 正确用法，可以稳定、可复用地生成符合规范的 Markdown 目录结构——关键不是“模板”，而是“可重复触发的生成逻辑”。
为什么 Markdown All in One 是首选
它不是简单插入一段静态文本，而是基于当前文档真实标题动态构建 TOC，每次执行 Create Table of Contents 命令都重新扫描、重新生成、重新锚定。这意味着：
- 标题改了（比如
## 配置说明→## 环境配置），再运行一次命令，链接自动更新，不会残留旧锚点 - 支持从
#到######全部六级标题，层级嵌套准确映射为缩进列表 - 生成的链接 ID 遵循 GitHub / VSCode 预览兼容规则：中文转小写拼音、空格变短横、去除标点（如
“API 设计”→api-she-ji） - 不依赖外部服务或网络，离线可用，Git 提交时变更清晰可见
Create Table of Contents 命令的实际行为
这个命令不会“猜”你想要什么位置或格式，它只做三件事：
- 定位光标所在行，在该行插入生成结果（不会覆盖已有内容）
- 默认只处理
#–###三级标题（可配）；若需包含四级及以上，需在设置中开启markdown.extension.toc.levels并设为6 - 生成的是无序列表（
- [xxx](#xxx)），不自动编号；如需有序，得手动改或配合其他插件 - 不会跳过带
{#custom-id}的标题——它会优先使用自定义 ID，这是控制锚点的可靠方式
容易被忽略的两个坑
很多人反复生成失败或链接失效，问题往往出在这两处：
- 标题含非法字符却没加自定义 ID：例如
## 使用 `npm install` 安装，反引号会被解析为内联代码，导致生成的锚点变成use-npm-install-install而非预期的使用-npm-install-安装；解决办法是显式写成## 使用 `npm install` 安装 {#install-with-npm} - 目录区域被误删或移动后未重生成：插件不监控“目录区块”，只响应命令；哪怕你手改了目录项，下次运行命令也会整段覆盖——所以别手动修生成后的目录，要改就改标题本身，再重跑命令
真正省时间的不是“一次建好”，而是“改完标题后按三下键就能同步”。盯住标题语义和 ID 控制，比找所谓“万能模板”靠谱得多。
