如何将 Markdown 文件高效转换为 PDF 文件

为什么需要将 MD 文件转为 PDF？

Markdown 是一种轻量级标记语言，用于编写文档、笔记和技术文章。然而，在正式分享、打印或提交给非技术用户时，PDF 格式更为通用和美观。PDF 能保留排版、字体和样式，且在不同设备上显示一致。

主流转换方法

1. 使用 Pandoc 命令行工具

Pandoc 是功能强大的文档转换瑞士军刀，支持多种格式互转。安装 Pandoc 后，在终端运行：

pandoc input.md -o output.pdf

如需自定义样式，可指定模板：pandoc input.md --pdf-engine=xelatex -o output.pdf。优点：高度可定制，批量处理；缺点：需安装 LaTeX 环境（较大）。

2. 使用 Typora 编辑器

Typora 是一款所见即所得的 Markdown 编辑器，内置 PDF 导出功能。打开 .md 文件，点击 文件 → 导出 → PDF 即可。支持主题样式，导出的 PDF 美观。优点：操作简单，界面友好；缺点：仅限桌面版，需付费（但可试用）。

3. 使用 Visual Studio Code 扩展

VSCode 安装 Markdown PDF 插件后，右键点击 .md 文件选择“Markdown PDF: Export (pdf)”即可。扩展还支持导出为 HTML、PNG 等。优点：免费，集成在编辑器中；缺点：需要配置，初次使用需安装依赖。

4. 在线转换工具

无需安装软件，访问 Markdown 转 PDF 网站（如 md2pdf.com、cloudconvert.com 等），上传 .md 文件或粘贴内容，点击转换即可。优点：跨平台，无需本地资源；缺点：需上传文件，有隐私风险，大文件可能受限。

高级技巧

如果需要批量转换多个 .md 文件，可以用 Pandoc 结合循环脚本（例如 Bash）：

for f in *.md; do pandoc "$f" -o "${f%.md}.pdf"; done

也可以使用 GitHub Actions 实现自动转换：在仓库中配置 CI 流水线，每次推送 Markdown 文件时自动生成 PDF。

常见问题

Q：生成的 PDF 中文乱码？ A：确保使用支持中文的 LaTeX 引擎（如 xelatex）并配置中文字体。在线工具一般已处理好。

Q：如何自定义页眉页脚？ A：使用 Pandoc 时，可通过 LaTeX 模板或 filter 实现。

Q：表格和代码块能否正常显示？ A：大多数工具支持，但复杂表格可能需调整。建议先导出测试。

总结

根据需求选择合适的方法：偏好命令行用 Pandoc，追求简单用 Typora，集成开发用 VSCode 扩展，临时转换用在线工具。掌握这些技巧，Markdown 转 PDF 变得轻松高效。