ctrl+k ctrl+t 失效主因是标题格式不规范：开头不能有空格或制表符，后不能紧接html注释；默认只识别1-3级标题，需手动配置toc.levels为"1-6"；手动编辑目录后将禁用自动更新。
快捷键本身不直接生成“目录树”，它只触发插件的目录生成逻辑；真正起作用的是 Markdown All in One 插件 + 规范标题语法 + 正确配置。
为什么 Ctrl+K Ctrl+T 没反应或只生成一级标题？
这个快捷键绑定的是 markdown.extension.toc.create 命令，但多数失败不是因为快捷键没设好，而是文档结构不被识别：
-
#标题行开头不能有空格或制表符，# 标题（前面带空格）会被跳过 - 标题后不能紧接 HTML 注释，
# 标题\n<!-- 说明 -->会导致该标题不参与解析 - 中文标题没问题，但插件默认把
## 环境准备转成锚点#环境准备，不是拼音也不是下划线，无需额外处理 - 默认只扫描
1-3级标题（即#到###），如需包含####及更深，必须手动改配置项markdown.extension.toc.levels为"1-6"
如何让保存时自动更新目录？
启用 toc.updateOnSave 后仍不生效，常见原因不是开关没开，而是插件主动“放弃更新”：
知识产权官文PDF转markdown
下载
Convert Chinese patent PDFs/DOCX/DOCs to structured Markdown. Supports patent publications (A/B/U) and office action documents (审查意见通知书/驳回决定/复审决定书/无效宣告请求审查决定书). Uses MinerU for high-quality OCR text extraction (falls back to Tesseract), Python scripts for
- 只要你在目录块里手动增删过内容（哪怕只加了个空格），插件就会标记该目录为“人工编辑”，此后不再覆盖
- 解决办法只有两个：删掉整个目录块，重新执行命令；或把光标放在目录块外再保存
- 自动更新不支持“局部刷新”，它要么全量重生成，要么完全跳过——没有中间态
目录生成后点击跳转失效怎么办？
链接能渲染出来，但点击没反应，通常和预览环境或锚点规则有关：
- VSCode 内置预览（
Ctrl+Shift+V）完全支持跳转，但某些第三方 Markdown 预览插件（如Markdown Preview Enhanced）可能不兼容插件生成的锚点格式 - GitHub / GitLab 渲染时，中文标题锚点是小写 + 连字符（如
#使用指南→#使用指南），但部分旧版 GitLab 需要github-slugger兼容模式，可在设置里开启markdown.extension.toc.slugifyMode设为"github" - 如果用
Preview to HTML导出，目录链接会丢失——因为导出走的是另一套渲染流程，不读取插件生成的 TOC 结构
最常被忽略的一点：插件不会校验标题是否唯一。两个 ## 安装 会产生相同锚点 #安装，导致第二个链接跳转到第一个位置——这不是 bug，是 Markdown 锚点本身的限制，得靠人工规避。
