VSCode 本身不自动生成目录树，必须依赖插件（如 Markdown All in One）并手动触发“Create Table of Contents”命令；常见无响应原因是插件未启用、文件语言模式非 Markdown 或非 .md 文件。
VSCode 本身不自动生成目录树，必须依赖插件（如 Markdown All in One）+ 手动触发命令才能生成可点击的链接目录；快捷键不是默认开启的，得靠插件注册并正确触发。
为什么 Ctrl+Shift+P 输入 “Create Table of Contents” 没反应？
常见错误是插件没装、没启用，或当前文件没被识别为 Markdown。检查以下几点：
-
Markdown All in One插件是否已安装且状态为“已启用”（在扩展面板里看 Enabled 标签） - 当前打开的文件后缀必须是
.md，且编辑器右下角语言模式显示为Markdown（点一下可手动切换） - 光标必须落在一个有效的 Markdown 文件内——比如你在
package.json里按Ctrl+Shift+P是搜不到该命令的 - 部分企业版或定制版 VSCode 可能禁用了扩展 API，可尝试在干净用户数据目录下启动验证：
code --user-data-dir=/tmp/vscode-test
生成的目录链接跳转失败，中文标题点不动怎么办？
这是锚点编码不一致导致的典型问题：VSCode 预览用的是 URL 编码（如 标题一 → %E6%A0%87%E9%A2%98%E4%B8%80），但某些插件生成的链接用的是拼音或删空格小写（如 biaoti-yi）。解决方式如下：
Kmind Markdown To Mindmap
下载
将 Markdown 标题大纲转换为 KMind 主题思维导图，支持主题预设、布局、连线方式、深色模式及彩虹分支，并可导出 PNG 或 SVG 图像。
- 确保使用
Markdown All in One而非老旧插件（如旧版markdown-tocCLI 工具） - 不要手动修改生成的链接文本，所有
[xxx](#xxx)必须由插件原生输出 - 若仍失效，在
settings.json中添加配置强制统一行为："markdown.extension.toc.slugifyMode": "github"
（该值适配 GitHub 风格锚点，对中文支持最稳） - 避免标题中出现
、！？等符号，它们在锚点里容易被截断或转义异常
如何让目录自动更新，而不是每次改标题都手动重生成？
Markdown All in One 默认不自动刷新目录，但可通过配置 + 小技巧模拟“准自动”效果：
- 启用保存时自动更新（需插件 v3.12+）：
"markdown.extension.toc.autoUpdate": true
- 配合
editor.formatOnSave触发时机更可靠，因为 TOC 更新本质是格式化操作 - 若想彻底免交互，可用
markdown-tocCLI 配合pre-commithook，在提交前统一重写 TOC（适合团队协作场景） - 注意：自动更新只扫描标题变更，不会感知你把
## A剪切粘贴到另一处——这种移动仍需手动重生成
侧边预览中目录不显示，或层级错乱怎么调？
VSCode 内置预览（Ctrl+Shift+V）不渲染目录，它只渲染文档内容本身。真正带目录的预览来自插件：
- 用
Markdown Preview Enhanced插件可开启独立预览窗口，支持左侧固定 TOC 面板（命令：Markdown Preview Enhanced: Open Preview to the Side） -
Markdown All in One的目录是插入到文档里的纯文本，所以必须先执行Create Table of Contents，再打开预览才能看到 - 层级错乱通常因混用缩进式列表和标题语法，例如用
- ## 标题这种写法会被误解析为列表项而非标题，务必保证标题独占一行且以#开头 - 预览中点击目录项无法滚动到对应标题？检查是否启用了
markdown.extension.preview.scrollPreviewWithEditor和反向同步选项
最容易被忽略的是：目录链接的可靠性高度依赖标题的“纯净性”——哪怕多一个不可见的零宽空格（），锚点就会断裂。建议在关键标题后加个空行，并用 VSCode 的“显示空白字符”功能（Ctrl+Shift+P → Toggle Render Whitespace）扫一遍。这不是 bug，是 Markdown 锚点机制本身的约束。
