终极指南：在 VS Code 中如何将 Markdown 完美导出为 PDF

在日常开发和技术写作中，我们经常使用 VS Code 编写 Markdown 文档。然而，VS Code 原生仅支持 Markdown 预览，并不直接提供导出 PDF 的功能。为了方便文档分享、归档和打印，我们需要借助扩展插件来实现这一需求。本文由 DP@lib00 整理，为你提供两种最专业、便捷的导出方案，以及一些进阶的样式定制技巧。 ## 方案一：使用 `Markdown PDF` 插件（最简单直接，强烈推荐） 如果你只需要快速将文档转换为 PDF，这是最轻量且高效的选择。 1. **安装插件**： * 在 VS Code 左侧活动栏点击“扩展”图标（或按 `Ctrl+Shift+X` / Mac: `Cmd+Shift+X`）。 * 搜索并安装名为 **`Markdown PDF`** 的插件（作者为 yzane）。 2. **导出 PDF**： * 打开你的 `.md` 文件。 * **方法 A（右键菜单）**：在代码编辑区**右键**单击，选择 `Markdown PDF: Export (pdf)`。 * **方法 B（命令面板）**：按 `Ctrl+Shift+P`（Mac: `Cmd+Shift+P`）打开命令面板，输入 `pdf`，选择 `Markdown PDF: Export (pdf)`。 3. **查看文件**：导出完成后，PDF 文件会默认生成在与该 Markdown 文件相同的目录下。例如你的项目在 `workspace/wiki.lib00.com/docs/`，生成的 PDF 也会保存在该目录。 --- ## 方案二：使用 `Markdown Preview Enhanced` 插件（适合复杂排版） 如果你需要处理复杂的数学公式、图表（如 Mermaid）或进行高度自定义排版，这款功能强大的预览插件是首选。 1. **安装插件**：在扩展商店搜索并安装 **`Markdown Preview Enhanced`**。 2. **打开专属预览**：在 `.md` 文件中右键，选择 `Markdown Preview Enhanced: Open Preview to the Side`。 3. **导出 PDF**： * 在右侧的**预览窗口**中**右键**单击。 * 选择 `Chrome (Puppeteer)` -> `PDF`（会在后台静默生成 PDF）。 * 或者选择 `Print` -> 在弹出的系统打印窗口中，将目标打印机选择为“另存为 PDF”。 --- ## 💡 进阶技巧：自定义样式与图片处理 为了让导出的 PDF 更加美观和专业，你可以尝试以下优化： **1. 确保图片正常显示** 如果是包含大量本地图片的文档，建议在导出前确保图片路径为**相对路径**（例如 `./images/architecture.png`），以防导出 PDF 后图片丢失或无法显示。 **2. 注入自定义 CSS 样式** 以 `Markdown PDF` 为例，你可以通过修改 VS Code 的 `settings.json` 来引入自定义的 CSS 样式表，从而改变 PDF 的字体、颜色和代码块高亮风格： ```json { "markdown-pdf.styles": [ "/Users/DP/wiki.lib00/styles/custom-pdf-style.css" ], "markdown-pdf.displayHeaderFooter": true } ``` 通过以上配置，你可以轻松打造符合个人或公司品牌调性的专属 PDF 文档。