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 路径写错这三处——检查它们比重装插件更有效。
