VS Code需借助插件与工具链导出高质量PDF/Word:用Markdown Preview Enhanced替代默认预览以支持公式、Mermaid等;PDF导出须配置Pandoc+LaTeX并自定义CSS;Word导出需reference.docx模板。

VS Code 本身不直接导出 PDF 或 Word,但通过合理组合插件与命令行工具,能稳定产出排版可控的 Markdown 文档。关键在预览实时性、导出格式一致性、样式自定义这三点。
用 Markdown Preview Enhanced 替代默认预览
VS Code 自带的 Markdown 预览功能简陋:不支持数学公式、图表(Mermaid)、目录跳转、主题切换,且无法导出。换成 Markdown Preview Enhanced(作者 shd101wyy)后,所有这些都可开箱即用。
- 安装后右键编辑器空白处,选
Markdown Preview Enhanced: Open Preview to the Side - 预览窗口支持实时同步滚动,按
Ctrl+K V(Windows/Linux)或Cmd+K V(macOS)快速呼出 - 公式需写成
$$ \int_0^1 x^2 dx $$形式,Mermaid 图要加```mermaid包裹 - 导出前务必先打开预览——否则导出会失败或内容缺失
导出 PDF 要配好 Pandoc + LaTeX 环境
仅靠插件无法生成真正“精美”的 PDF:默认导出是网页快照,字体糊、页边距错、目录不生成。必须走 pandoc 渲染路径,而它依赖本地 LaTeX 引擎(如 texlive 或 MacTeX)。
- 先装
pandoc:brew install pandoc(macOS)、scoop install pandoc(Windows) - 再装完整 LaTeX 发行版:
sudo apt install texlive-full(Ubuntu),或下载MacTeX(macOS)、TeX Live(Windows) - 在 VS Code 设置中搜
mpe.exportPandocPath,填入pandoc可执行文件绝对路径(如/usr/local/bin/pandoc) - 导出时右键 →
Markdown Preview Enhanced: Export to PDF,插件会自动调用pandoc+pdflatex
用 CSS 文件定制导出样式(HTML / PDF)
导出的 HTML 或 PDF 默认样式单调。可通过自定义 CSS 控制字体、标题层级、代码块高亮、页眉页脚等。注意:PDF 导出只认部分 CSS 属性(如 @page、font-family),不能用 Flex/Grid。
- 新建
style.css,放在项目根目录或.vscode/下 - 在 VS Code 设置里配置
mpe.stylesheetPath指向该文件 - PDF 导出有效样式示例:
body {
font-family: "Noto Serif CJK SC", "PingFang SC", serif;
line-height: 1.6;
}
h1 { color: #2c3e50; border-bottom: 2px solid #3498db; padding-bottom: 0.2em; }
@page { margin: 2cm; }
code { background: #f8f8f8; padding: 0.1em 0.3em; }
HTML 导出可放开用现代 CSS,PDF 则建议只动字体、间距、页边距和基础颜色。
导出 Word(.docx)要提前准备 reference.docx
Markdown Preview Enhanced 导出 Word 不是简单转换,而是用 pandoc 把 Markdown 渲染进一个模板文档。没有模板,格式会崩:标题变正文、列表缩进错、代码块无底色。
- 从
pandoc官网下载空白reference.docx(搜索 “pandoc reference docx”) - 用 Word 打开它,修改标题样式(
Heading 1、Heading 2)、正文、代码块等格式,保存 - 在 VS Code 设置中配置
mpe.exportDocxReferenceFile指向该文件 - 导出时选
Export to DOCX,样式即生效
导出链路越长(MD → Pandoc → LaTeX/Word),中间任一环节缺失或路径错误都会静默失败。最常卡在 pandoc 找不到、LaTeX 缺宏包、CSS 路径写错这三处——检查它们比重装插件更有效。










