如何用vscode进行Markdown写作_预览与导出精美文档指南【教程】

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