Markdown 转 PDF 完全指南

在技术写作、学术笔记或项目文档中，Markdown 因其简洁的语法和高效的编辑体验备受青睐。然而，许多场景需要将 Markdown 转换为 PDF 以便打印、分享或归档。本文系统梳理了主流转换方案、操作步骤和常见问题。

为什么需要转换？

Markdown 是纯文本格式，不具备分页、页眉页脚等布局能力。PDF 则能保留排版、字体，且跨平台显示一致。转换需求通常来自：

• 交付给客户的正式文档
• 学术论文或报告提交
• 电子书或手册制作
• 个人简历或作品集

主流转换工具

1. Pandoc（命令行，万能转换器）

Pandoc 是开源文档格式转换工具，支持 Markdown 转 PDF。需要配合 LaTeX 引擎（如 TeX Live、MiKTeX）生成美观的 PDF。

pandoc input.md -o output.pdf --pdf-engine=xelatex -V CJKmainfont='SimSun'

优点：高度可定制，支持书签、目录、代码高亮。缺点：需安装 LaTeX 环境（较大）。

2. Typora（所见即所得编辑器）

Typora 支持直接导出 PDF，内置 Pandoc 引擎。操作：文件 > 导出 > PDF。可通过主题和自定义 CSS 调整排版。

优点：无需命令，实时预览。缺点：仅限 Typora 中编辑的文档。

3. VSCode 插件

使用 Markdown PDF 扩展，一键导出。或通过 Markdown Preview Enhanced 插件，右键选择“PDF (Chrome)”。

优点：集成在编辑器，方便。缺点：依赖浏览器或引擎。

4. 在线转换器

如 md2pdf、markdowntopdf.com。直接上传 .md 文件，在线生成 PDF。

优点：无需安装。缺点：有隐私风险，样式有限。

5. 专业工具

Markdown 编辑器如 iA Writer、Ulysses 也支持导出为 PDF，并提供字体、页边距等设置。

转换注意事项

• 中文字体：使用 Pandoc 或 LaTeX 时需指定中文字体，否则出现乱码。
• 代码块：确保代码高亮样式（如 monokai）在 PDF 中生效。
• 数学公式：支持 LaTeX 数学公式的引擎如 MathJax 需开启。
• 图片路径：使用绝对路径或相对路径，PDF 中图片需嵌入。
• 页眉页脚：部分工具可通过模板或设置添加。

最佳实践

1. 使用 Pandoc 配合自定义 CSS 或 LaTeX 模板，获得最专业的排版。
2. 对于简单文档，使用 Typora 或在线工具快速生成。
3. 对中文文档，推荐 XeLaTeX 引擎并设置系统宋体或思源字体。
4. 转换前检查 Markdown 的规范性（如列表、表格的闭合）。
5. 测试不同工具的输出，选择最适合自身需求的方案。

总结

Markdown 转 PDF 并非难事，关键是根据使用场景选择合适的工具。日常轻量转换可选 Typora 或在线工具；高质量专业文档则推荐 Pandoc + LaTeX。掌握这些方法，将极大提升文档处理效率。