Markdown All in One 快捷键不生效主因是 VSCode 默认快捷键冲突且插件未启用键盘覆盖；Ctrl+K Ctrl+T 生成目录失败多因标题格式不规范；TOC 自动更新失效源于手动编辑触发保护机制；PDF 导出目录丢失系外部导出工具未适配插件生成的 HTML 结构。
为什么 Markdown All in One 的快捷键不生效？
多数人装完插件发现 Ctrl+Shift+P 输入“Preview”能打开预览，但 Ctrl+B 加粗、Ctrl+I 斜体完全没反应——根本原因是 VSCode 默认快捷键和插件快捷键冲突，且插件默认未启用“键盘快捷键覆盖”。
- 打开
Settings（Ctrl+,），搜索markdown.extension.onTypeRenderers，确保为true - 在快捷键设置里（
Ctrl+K Ctrl+S）搜toggleBold，确认绑定的是markdown.extension.toggleBold，不是编辑器默认的editor.action.toggleBold - 如果用 macOS，注意
Cmd替换Ctrl；部分键盘布局（如中文输入法激活时）会吞掉组合键，切英文输入法再试
如何让 Ctrl+K Ctrl+T 正确生成当前文档的目录？
这个快捷键本应触发 markdown.extension.toc.create，但常出现“无标题”或只生成一级标题——本质是插件依赖文档中真实存在的 ATX 标题（# 一级、## 二级），且对空格、缩进、换行敏感。
- 标题行不能有前置空格或制表符，
# 标题（全角空格）或# 标题都会被忽略 - 标题后不能紧跟 HTML 注释或空行，
# 标题\n<!-- 注释 -->会导致该标题不被识别 - 想包含所有层级？修改配置项
markdown.extension.toc.levels，设为"1-6"（默认是"1-3"）
toc.updateOnSave 自动更新目录却总失败？
开启后保存文件本该自动刷新目录，但有时目录纹丝不动，甚至删掉重生成都无效——这不是 bug，而是插件检测到目录块被手动编辑过，就主动放弃自动更新，避免覆盖人工调整。
- 检查目录块是否含非自动生成内容，比如手写的
[跳转链接](#xxx)或注释<!-- toc --> - 若需保留人工修改又想自动更新，把目录块放在文档末尾，并确保其上方有至少一个空行，插件会识别为“独立区域”而绕过保护
- 临时强制更新：光标置于目录块内，按
Ctrl+Shift+P→ 输入Markdown: Update table of contents
导出 PDF 时目录丢失或层级错乱怎么办？
Markdown All in One 本身不处理导出，它依赖 Markdown PDF 或 Typora 等外部工具。目录丢失通常是因为导出器没解析插件生成的 TOC HTML 结构，或者用了错误的 CSS 模板。
- 用
Markdown PDF插件时，必须在设置中启用markdown-pdf.includeDefaultStyles，否则自定义 TOC 的 class（如md-toc）无样式，渲染成纯文本 - 若用命令行导出（如
pandoc），别直接读取原始 Markdown，先用插件生成并保存 TOC，再导出——因为 pandoc 不认识markdown.extension.toc的语法扩展 - 最稳方案：预览时右键 →
Save As HTML，再用浏览器打印为 PDF，这样 100% 保留插件生成的目录结构和锚点
实际用下来，最难调的不是功能开关，而是文档格式的“隐形洁癖”：一个多余空格、一次手动编辑目录、一种没配对的引号，都可能让整个 TOC 流程静默失败。建议把 Ctrl+Shift+P → Developer: Toggle Developer Tools 打开控制台，看有没有 TOC generation skipped 类提示——它比任何文档都诚实。
