系列名：《从 0 到 1：14 天 Markdown 实战入门（VS Code 版）》
更新节奏：每天 1 章，共 14 章
本章难度：⭐⭐⭐☆☆
本章关键词：导出、PDF、HTML、Word、Pandoc、GitHub、静态站点、发布
1. 本章导读
前面十二章，我们一直在“写” Markdown。但写完之后呢？
Markdown 只是源文件，最终你要把它变成可交付的成果：
- 发给同事的 PDF 文档。
- 提交给客户的 Word 文件。
- 发布到 GitHub 的 README。
- 部署到网上的博客文章。
- 导出为 HTML 的在线文档。
这一章我们要解决 Markdown 的“最后一公里”：导出与发布。
你会学到：
- 如何把 Markdown 导出为 HTML。
- 如何打印为 PDF。
- 如何用 Markdown Preview Enhanced 导出多种格式。
- 如何用 Pandoc 转换文档。
- 如何写 GitHub README。
- 如何把 Markdown 发布到静态博客。
- 一个完整的导出与发布流程。
2. 学习目标
完成本章后，你应当能够：
- 使用 VS Code 导出 HTML。
- 使用浏览器打印为 PDF。
- 使用 Markdown Preview Enhanced 导出 PDF、HTML、PNG、EPUB。
- 了解 Pandoc 的基本用法。
- 写规范的 GitHub README。
- 理解静态站点生成器的工作流程。
- 把 Markdown 发布到 GitHub Pages。
- 完成从写作到发布的完整流程。
- 识别并解决导出中的常见问题。
3. 理论讲解
3.1 导出格式概览
Markdown 可以导出为多种格式：
| 格式 | 用途 | 工具 |
|---|---|---|
| HTML | 网页、在线文档 | VS Code、MPE、Pandoc |
| 打印、正式文档 | 浏览器、MPE、Pandoc | |
| Word | 协作、交付 | Pandoc、Typora |
| PNG | 图片分享 | MPE、Mermaid Live |
| EPUB | 电子书 | Pandoc、MPE |
| PPT | 演示 | Pandoc、Marp |
| Markdown | 源文件 | 本身 |
选择建议：
- 发给同事：PDF 或 Word。
- 发布网站：HTML 或静态站点。
- 开源项目：GitHub README。
- 电子书：EPUB 或 PDF。
- 演示：Marp 或 PPT。
3.2 VS Code 内置导出 HTML
VS Code 内置预览可以导出 HTML。
步骤：
- 打开 Markdown 文件。
- 打开预览：
Ctrl + Shift + V/Cmd + Shift + V。 - 在预览中右键，选择“复制为 HTML”或“打印”。
- 或使用命令面板：
Markdown: Print Current Document to HTML注意：
- 内置导出功能有限。
- 样式比较简单。
- 复杂公式、Mermaid、代码高亮可能丢失。
- 适合简单文档。
3.3 浏览器打印为 PDF
最简单的方式：
- 打开 Markdown 预览。
- 在预览中右键，选择“在浏览器中打开”。
- 浏览器中按
Ctrl + P/Cmd + P。 - 选择“另存为 PDF”。
- 调整页面设置。
优点：
- 不需要额外工具。
- 样式相对可控。
- 支持大部分 Markdown 语法。
缺点：
- 分页不精确。
- 代码块可能被截断。
- 公式和 Mermaid 可能丢失。
3.4 Markdown Preview Enhanced 导出
Markdown Preview Enhanced 是导出功能最强大的插件之一。
支持导出：
- HTML
- PNG
- JPEG
- EPUB
- Pug
- Pandoc
- 电子书
步骤：
- 打开增强预览：
Markdown Preview Enhanced: Open Preview- 在预览中右键，选择“Export”。
- 选择目标格式。
导出 PDF：
Markdown Preview Enhanced: Chrome (Puppeteer) -> PDF导出 HTML：
Markdown Preview Enhanced: HTML -> HTML导出 PNG：
Markdown Preview Enhanced: Chrome (Puppeteer) -> PNG3.5 配置 Markdown Preview Enhanced 导出
导出 PDF 配置示例：
{"markdown-preview-enhanced.chromeExecutablePath":"","markdown-preview-enhanced.puppeteer":{"args":["--no-sandbox"]},"markdown-preview-enhanced.pdf":{"format":"A4","printBackgro
