VS Code 自带 Markdown 预览不支持数学公式、Mermaid 图表、CSS 注入和右侧同步滚动；需搭配 Markdown All in One（补全快捷键、TOC、导出）与 Markdown Preview Enhanced（支持 LaTeX、Mermaid、脚注、CSS 注入）协同使用。
VS Code 写 Markdown 本身不需要插件就能实时预览，但默认预览功能有限——它不支持数学公式、Mermaid 图表、自定义 CSS 或右侧同步滚动。要真正好用，得靠插件补足。
VS Code 自带预览怎么开？
按 Ctrl+Shift+V（Windows/Linux）或 Cmd+Shift+V（macOS）即可在右侧打开预览窗；也可以右键编辑器内任意 .md 文件 → “Open Preview”。
这个预览是纯静态的：不执行 JS、不渲染 $$...$$ 数学公式、不解析 ```mermaid 块。如果你只写简单文档，够用；一旦加了图表或公式，就会看到原样代码块。
推荐插件：Markdown All in One + Markdown Preview Enhanced
这两个不是二选一，而是互补使用：
-
Markdown All in One：补全快捷键（如Ctrl+Enter插入列表/标题）、TOC 自动生成、格式化、快捷导出 PDF/HTML -
Markdown Preview Enhanced：真正解决“实时渲染”痛点——支持 LaTeX 公式、Mermaid、PlantUML、脚注、目录跳转、甚至本地 CSS 注入
装完后者后，右键 → “Open Preview to the Side” 就能启用增强预览；默认快捷键仍是 Ctrl+K V（注意不是 Ctrl+Shift+V）。
常见问题和坑
这些细节不注意，预览就白装：
- Mermaid 渲染失败？检查是否在代码块中写了
```mermaid（不是```mermaid-js或漏了语言标识） - 公式不显示？确保公式用
$$...$$或\[...\]包裹，且插件设置里启用了enableExtendedMath - 预览里图片路径错乱？VS Code 默认按当前文件所在目录解析相对路径，
要确保img/logo.png相对于 .md 文件存在 - 中文目录 TOC 乱码？把 VS Code 的文件编码设为
UTF-8（右下角点击编码 → Save with Encoding → UTF-8）
复杂点在于：不同插件对同一语法的支持程度不同，比如 Markdown Preview Enhanced 支持 %%{init: ...}%% 初始化 Mermaid 配置，而 Markdown All in One 完全不识别。别指望一个插件包打天下，得看你要什么功能再组合用。
