vscode内置markdown预览需手动启用：按ctrl+shift+v（win/linux）或cmd+shift+v（macos）打开，仅保存后刷新，不支持数学公式与mermaid；如需实时+公式+图表，推荐markdown all in one与markdown preview enhanced组合使用。
VSCode 自带 Markdown 支持，但默认预览不自动刷新、不支持数学公式和 Mermaid 图表——得靠插件补足。
怎么启用 VSCode 内置的 Markdown 预览
不用装插件也能看效果：Ctrl+Shift+V（Windows/Linux）或 Cmd+Shift+V（macOS）打开侧边实时预览。注意：它只响应保存后的文件变更，编辑时不会自动刷新；且不解析 $$ 包裹的 LaTeX 公式，也不渲染 mermaid 代码块。
- 预览窗口右上角三个点 → 可切换「滚动同步」或「锁定滚动」
- 想用浏览器打开？右键预览页 →
Open Preview to the Side后再右键 →Reveal in Explorer，然后拖到浏览器标签页（本质是本地file://URL） - 如果预览空白，先检查文件后缀是不是
.md，且没被误设为其他语言模式（右下角状态栏点开确认是Markdown）
哪些插件能真正解决「实时+公式+图表」需求
推荐两个组合使用：Markdown All in One（补全快捷键、目录、导出） + Markdown Preview Enhanced（MPE，唯一稳定支持实时热更新、LaTeX、Mermaid、PlantUML 的预览插件）。
-
Markdown Preview Enhanced安装后需重启 VSCode，首次打开.md文件会提示初始化，选「Yes」 - 它的预览快捷键是
Ctrl+K V（不是Ctrl+Shift+V），且编辑时敲字 300ms 后自动刷新，无需保存 - 公式要生效，必须在设置里开启：
markdown-preview-enhanced.enableExtendedSyntax设为true；Mermaid 需额外安装mermaid-cli（npm install -g mermaid-cli）并配置markdown-preview-enhanced.mermaidPath - 别装
Markdown Preview Mermaid Support这类单功能插件——它和 MPE 冲突，会导致预览崩溃
为什么改了设置却没生效？常见配置陷阱
VSCode 的 Markdown 设置分三层：全局设置、工作区设置、语言专属设置。MPE 的关键选项只在「工作区设置」或「用户设置」里生效，且必须写对字段名。
- 比如让预览默认显示目录，得加这段进
settings.json："markdown-preview-enhanced.previewTheme": "github.css",<br>"markdown-preview-enhanced.enableScriptExecution": true,
- 路径类配置（如
mathJaxPath）务必用双反斜杠\或正斜杠/，Windows 下写C:xxx会报错 - 如果数学公式渲染成原始文本，大概率是
$$E=mc^2$$写成了$E=mc^2$（单美元只支持行内公式，且需开启enableExtendedSyntax） - Mermaid 图不显示？检查控制台（
Ctrl+Shift+P→Developer: Toggle Developer Tools）有没有Failed to load mermaid报错
MPE 的配置项多、文档分散，最容易卡在「路径没填对」或「扩展语法开关没开」这两步——建议先复制官网最小配置跑通，再逐步加功能。
