vs code原生不支持markdown转pdf，稳定导出高清技术文档仅有两条路径：markdown preview enhanced配puppeteer（截取真实渲染dom快照，支持mermaid/公式/高亮），或pandoc配xelatex（出版级排版，需完整latex环境与中文字体配置）。
VS Code 原生不支持 Markdown 转 PDF，所谓“内置插件”实际不存在——所有可用方案都依赖第三方扩展 + 外部工具链。真正能稳定导出高清、带 Mermaid/公式/代码高亮的技术文档的，只有两个路径：Markdown Preview Enhanced（MPE）配 Puppeteer，或 Pandoc 配 XeLaTeX。
为什么 Markdown PDF 插件导出后字体糊、公式消失、Mermaid 不渲染
Markdown PDF（作者 yzane）底层调用的是 wkhtmltopdf，它是个静态 HTML 渲染器，不执行 JavaScript。而 Mermaid 图表、MathJax 公式、甚至部分代码块高亮（如通过 highlight.js 动态注入的样式）都依赖 JS 运行时。结果就是：
- 预览里能看到的流程图，导出 PDF 后变成空白或文字描述
- $$ \sum_{i=1}^n i $$ 渲染失败，只显示原始 LaTeX 字符串
- 中文字体 fallback 缺失，PDF 里中文显示为方块或直接丢弃
- 导出大文档（>300 行）时进程被系统 kill，报错
Exit with code -9
这不是配置问题，是工具链能力边界。别在 markdown-pdf.styles 里反复试 CSS——JS 不执行，CSS 再多也无效。
用 Markdown Preview Enhanced 导出真实渲染 PDF 的硬性前提
MPE 的导出本质是“截取当前预览页的完整 DOM 快照”，所以它必须先有正确渲染的预览页。常见失败不是因为没点对菜单，而是预览根本没加载成功：
- 必须先右键打开
Markdown Preview Enhanced: Open Preview to the Side，不能只靠 VS Code 自带的Ctrl+Shift+V预览——后者不支持 Mermaid 和公式 - 预览窗口里要能看到 Mermaid 图、$$ 公式已转为清晰 SVG、代码块有语法色——否则导出必丢内容
- 确保
puppeteer可用：npm install -g puppeteer，且系统允许无头 Chrome 启动（macOS 可能需手动授权） - 导出前检查 YAML front matter 是否含
pdf_options，例如：---\npdf_options:\n format: 'A4'\n margin: {top: '20mm', right: '15mm', bottom: '20mm', left: '15mm'}\n---
Pandoc + XeLaTeX 是唯一能生成出版级 PDF 的组合
如果你需要目录页、页眉页脚、自动编号、跨页表格、精确中文字体控制（比如用思源宋体 + Fira Code），pandoc 是绕不开的。但注意几个致命细节：
- 必须用
--pdf-engine=xelatex，pdflatex对中文支持为零，会直接报错退出 - LaTeX 发行版必须完整：Ubuntu 上
sudo apt install texlive-full，macOS 上装 MacTeX（不是 BasicTeX），Windows 上装 TeX Live 并勾选全部宏包 - 命令行导出最稳：
pandoc input.md -o output.pdf --pdf-engine=xelatex -V mainfont="Noto Serif CJK SC" -V monofont="Fira Code" - VS Code 中配置
mpe.pandocPath时，填的是绝对路径，比如 macOS：/opt/homebrew/bin/pandoc，Windows：C:\Users\name\AppData\Roaming\Local\Pandoc\pandoc.exe
最容易被忽略的三个实操断点
90% 的导出失败不是因为不会装插件，而是卡在这三处：
-
Markdown Preview Enhanced的预览窗口未激活就右键导出——导出的是空页或旧缓存 - 以为装了 Pandoc 就万事大吉，却没装完整 LaTeX，导致
pandoc报Could not find engine xelatex - 在
markdown-pdf设置里改了一堆 CSS，却忘了它根本不解析<style></style>或@import，只认内联 style 和有限的 HTML 属性
导出高清技术文档的关键，从来不是“点哪里”，而是确认渲染链路每一环都真实跑通：编辑 → 实时预览（JS 执行完成）→ 快照捕获（Puppeteer）或格式编译（Pandoc+XeLaTeX）→ PDF 生成。
