在VS Code中渲染 Markdown 并保存为 PDF

在 Visual Studio Code (VS Code) 中渲染 Markdown 并保存为 PDF，可以通过以下步骤实现。提供两种常用方法，选择适合你的方案：

---

方法一：使用插件直接导出（推荐）

1. 安装必要插件

• Markdown Preview Enhanced（增强预览）
  提供强大的 Markdown 渲染和导出功能。
  在 VS Code 扩展商店搜索并安装。

• Markdown PDF（直接导出为 PDF）
  支持一键将 Markdown 文件转换为 PDF。

---

2. 使用 Markdown Preview Enhanced 导出

1. 预览 Markdown
   打开 Markdown 文件，右键选择 Markdown Preview Enhanced: Open Preview，右侧会渲染出排版后的内容。

2. 导出为 PDF
   在预览页面右键，选择 Chrome (Puppeteer) -> PDF，直接生成 PDF 文件。

---

3. 使用 Markdown PDF 插件导出

1. 直接右键导出
   在 Markdown 文件中右键，选择 Markdown PDF: Export (pdf)，插件会自动生成 PDF。

2. 自定义样式（可选）
   如果默认样式不满足需求，可添加自定义 CSS：

   • 创建 .vscode/settings.json 文件，添加以下配置：

     {
       "markdown-pdf.styles": [
         "https://cdnjs.cloudflare.com/ajax/libs/github-markdown-css/5.1.0/github-markdown.min.css",
         "/path/to/your/custom.css"
       ]
     }
     

---

方法二：通过浏览器打印（无需插件）

1. 预览 Markdown
   在 VS Code 中按 Ctrl+K V（Windows/Linux）或 Cmd+K V（Mac）打开侧边预览。

2. 用浏览器打开
   右键点击预览页面，选择 在浏览器中打开（需要安装 Open in Browser 插件）。

3. 打印为 PDF
   在浏览器中按 Ctrl+P（Windows/Linux）或 Cmd+P（Mac），选择目标打印机为 另存为 PDF，调整页边距等设置后保存。

---

方法三：使用 Pandoc + LaTeX（高级用户）

1. 安装 Pandoc 和 LaTeX

   • Pandoc 安装指南
   • LaTeX 发行版（如 TeX Live）

2. 通过 VS Code 终端运行命令
   在 Markdown 文件目录下执行：

   pandoc input.md -o output.pdf --pdf-engine=xelatex -V mainfont="Microsoft YaHei"
   

   • mainfont 可指定中文字体（如 Windows 下的 Microsoft YaHei，Mac 下的 PingFang SC）。

---

常见问题解决

1. 中文乱码

   • 确保使用支持中文的字体（如方法三中的 mainfont 参数）。
   • 在 Markdown 文件开头添加元信息：

     ---
     fontfamily: "Microsoft YaHei"
     ---
     

2. 代码块换行问题
   在自定义 CSS 中添加：

   pre {
     white-space: pre-wrap;
   }
   

3. 插件依赖缺失

   • Markdown PDF 需要 Chromium，若下载失败可手动安装：

     npm install puppeteer --global
     

---

总结

• 推荐新手：使用 Markdown Preview Enhanced 或 Markdown PDF 插件一键导出。
• 需要精细控制样式：结合自定义 CSS 或 Pandoc + LaTeX。
• 快速导出：浏览器打印法最快捷，但排版可能简单。