插件安装后快捷键没反应，根本原因是vs code未将文件识别为markdown：需确认文件后缀为.md、右下角语言模式设为markdown、启用markdown.extension.ontyperenderers，并确保快捷键未被其他插件覆盖。
插件安装后为什么快捷键没反应
多数人装完就以为能用，结果 Ctrl+B 加粗、Ctrl+2 插入二级标题全没响应——根本原因不是插件坏了，而是 VS Code 没把它当“Markdown 编辑器”用。
必须确认三件事：
- 当前文件后缀是
.md，且右下角语言模式显示为Markdown（点一下手动切） - 设置里
markdown.extension.onTypeRenderers已启用（搜这个配置项并勾选） - 快捷键没被其他插件覆盖：打开
Ctrl+K Ctrl+S，搜toggleBold，确保绑定的是markdown.extension.toggleBold，不是editor.action.toggleBold
目录生成失败的常见写法陷阱
Ctrl+K Ctrl+T 按了没反应，或生成的目录缺标题、链接点不动，90% 是标题格式踩了坑。
插件只认标准 ATX 标题，且极其敏感：
- 标题行开头不能有空格或制表符：
# 标题✅，# 标题❌ - 标题后不能紧接 HTML 注释：
# 标题\n<!-- 备注 -->会导致该标题被跳过 - 默认只扫描
#到###（1–3 级），要包含####得改配置：markdown.extension.toc.levels设为"1-6" - 光标必须放在想插入目录的位置（比如文档顶部或
## 目录下方），否则可能插到段落中间
预览不渲染公式、目录跳转失效怎么办
这不是 bug，是 VS Code 原生预览和插件功能冲突导致的典型症状。必须禁用原生预览，只用插件自己的预览链路。
关键操作只有两步：
pdf文档转markdown
下载
将PDF文件（含扫描件、图片）转换为Markdown格式。接入MinerU和PaddleOCR双引擎，支持扫描件OCR识别、公式表格解析、多语言识别。兼容本地OCR识别。
- 在设置中把
markdown.preview.enabled设为false（或直接加进settings.json） - 启用插件专属数学支持：
markdown.extension.math.enabled设为true
之后所有预览都得用插件快捷键触发：Ctrl+K V（Windows/Linux）或 Cmd+K V（macOS）。别再用 Ctrl+Shift+V，那是原生预览的残留绑定。
TOC 更新不自动？你删过它
markdown.extension.toc.updateOnSave 不是“监听标题变化自动重写整个 TOC”，而是“保存时就地刷新已有目录块”。它只对插件亲手生成、且没被手动破坏的目录结构生效。
一旦你全选删掉再手打一个 - [xxx](#xxx)，插件就放弃接管。
正确流程是：
- 首次必须用命令创建：
Ctrl+Shift+P→ 输入Markdown All in One: Create Table of Contents - 后续更新时，光标必须落在已有 TOC 的任意一行内，再执行同一命令
- 若想排除某标题，就在它上面加一行注释：
<!-- omit from toc -->
中文标题锚点在 GitHub 预览里常乱码（如 #%E4%B8%AD%E6%96%87），验证是否真可用，只看两个地方：Ctrl+Shift+O 打开大纲面板（100% 可跳），或导出 HTML 后用浏览器打开。
