VS Code原生预览(Ctrl+Shift+V)默认不支持数学公式、Mermaid图表及PDF导出;需在1.84+版本中启用scrollEditorWithPreview与scrollPreviewWithEditor双同步开关,并开启mathjax渲染,且文件须保存后才更新预览。

VS Code 原生 Markdown 预览(Ctrl+Shift+V)默认不支持数学公式、Mermaid 图表,也不提供导出 PDF 功能;所谓“实时预览”在未开启自动刷新时其实是手动触发的——关键不是装多少插件,而是选对路径并配准几个布尔值和路径。
启用原生实时预览与数学公式渲染
VS Code 1.84+ 版本已内置基础实时能力,但需手动打开两个开关,否则滚动不同步、公式不渲染:
-
"markdown.preview.scrollEditorWithPreview"和"markdown.preview.scrollPreviewWithEditor"必须同时设为true,只开一个会导致单向卡顿 - 数学公式依赖
"markdown.preview.mathjax"(旧版叫math.enabled),设为true后,公式需前后空行才能生效,例如:$$\int_0^1 x^2 dx$$
- 语言模式必须是
Markdown(右下角状态栏确认),且文件保存后才触发预览更新;未保存的编辑内容不会反映在预览中
用 Markdown Preview Enhanced 支持 Mermaid 与公式实时渲染
原生预览不加载 Mermaid、不支持自定义 CSS、无法导出,这时要换插件。但注意:Markdown Preview Enhanced(MPE)作者已停止维护,VS Code 1.80+ 后易出现预览白屏或样式错乱,建议仅用于需要 Mermaid 或复杂公式渲染的场景:
- 安装后用
Ctrl+K M(不是Ctrl+Shift+V)调出 MPE 预览,它才真正解析```mermaid和$$...$$ - MPE 的导出功能基于 HTML 快照,所以预览里看不到的内容(比如被 CSS 隐藏的块),导出 PDF 也一定没有
- 若导出失败提示
Puppeteer launch failed,大概率是系统没装 Chrome/Edge,或权限被拒;可改用HTML to PDF via Chrome模式绕过 Puppeteer
导出 PDF 的三种可靠路径
VS Code 没有内置导出能力,所有 PDF 导出都走外部工具链,选哪条取决于你文档的复杂度:
-
轻量文档(无公式/图表):装
Markdown PDF插件(作者 yzane),它调用本地 Chrome 渲染,只要系统有chrome或msedge命令即可,无需 LaTeX -
含中文公式/复杂排版:用
Markdown Preview Enhanced+pandoc+xelatex,关键命令是:pandoc input.md -o output.pdf --pdf-engine=xelatex
不用pdflatex,否则中文直接乱码 -
批量导出需求:写 VS Code
tasks.json调用markdown-pdfCLI 工具,避免点右键,适合多文件自动化
最容易被忽略的是:所有导出路径都依赖「预览先正确渲染」。如果 MPE 预览里公式是乱码、Mermaid 不动,导出 PDF 一定也是错的;不要跳过预览验证这一步,也不要指望插件自动修复语法错误。



















