Markdown All in One 是 VSCode 中实现 Markdown 高级功能的首选插件，需搭配 Markdown Preview Mermaid Support 等依赖启用数学公式、Mermaid 图表、TOC 和 PDF 导出等功能，且必须手动配置关键选项才能生效。
vscode 自带基础 markdown 支持，但要获得实时预览、目录导航、数学公式、图表渲染等能力，必须安装专用插件——markdown all in one 是目前最稳定、功能最全的首选。
为什么不用 VSCode 默认预览？
VSCode 内置的 Ctrl+Shift+V 预览只支持基础语法，不解析 $$ 数学块、不渲染 Mermaid 流程图、不生成目录（TOC）、无法一键导出 PDF。很多用户装完就发现“写起来很卡”或“公式不显示”，其实是没启用扩展支持。
必装插件：Markdown All in One + 它的依赖
仅装 Markdown All in One 不够，它依赖 VSCode 原生的 Markdown Preview Enhanced 或 Markdown Preview Mermaid Support 来补全关键能力。推荐组合如下：
-
Markdown All in One：提供快捷键（如Ctrl+K Ctrl+T插入目录）、自动补全、格式化、侧边 TOC -
Markdown Preview Mermaid Support：让预览窗口能正确渲染mermaid图表（需在设置中启用） - 可选：
Markdown PDF：导出为 PDF 时保留样式和图表（注意：它依赖系统已安装Chrome或Chromium）
安装后重启 VSCode，再打开任意 .md 文件，按 Ctrl+Shift+V，右上角会出现「Open Preview to the Side」按钮——点击即可并排编辑与预览。
关键配置项必须手动开启
插件默认不启用部分高级功能，容易误以为“没效果”。以下三项必须检查：
- Mermaid 渲染：打开设置（
Ctrl+,），搜索markdown.preview.mermaid，勾选Enable Mermaid preview - 数学公式：搜索
markdown.preview.math，确保设为true；公式需用$$...$$或\[...\]包裹才生效 - 自动更新预览：搜索
markdown.preview.autoShowPreviewToSide，设为true，避免每次都要手动点开
配置保存后，新建一个测试文件，粘贴以下内容验证：
```mermaid
graph LR
A[开始] --> B{条件}
B -->|是| C[执行]
B -->|否| D[退出]
```如果右侧预览中显示流程图，说明 Mermaid 已就绪。
常见问题与绕过方案
遇到预览空白、公式乱码、Mermaid 不渲染，先别重装插件，按顺序排查：
- 确认文件后缀是
.md（不是.txt或无后缀）；右下角语言模式必须显示Markdown - 禁用其他 Markdown 插件（如旧版
Markdown Preview Enhanced），它与Markdown All in One冲突严重 - 预览窗口右键 →
Open Preview to the Side比快捷键更可靠；若仍空白，尝试关闭所有窗口，重新用资源管理器打开该文件夹 - 导出 PDF 失败？检查系统是否安装了 Chrome，并在设置中将
markdown-pdf.executable指向chrome.exe或chromium-browser路径
Mermaid 和数学公式这类功能，不是“装了就跑”，而是依赖 VSCode 的预览内核 + 插件配置双生效。漏掉任一环，都会表现为“写了但看不到”。
