为什么需要将Markdown转换为PDF/Word？

Markdown凭借其简洁的语法和纯文本特性，已成为写作、技术文档和笔记的流行格式。但在实际交付中，PDF和Word仍是商务、学术及出版领域最通用的格式。因此，掌握将Markdown高效转换为PDF/Word的方法，是每位写作者和开发者的必备技能。

主流转换工具对比

1. Pandoc —— 瑞士军刀级工具

Pandoc是一款命令行工具，支持几乎所有标记格式之间的转换。要将Markdown转为PDF，你需要配合LaTeX引擎（如xelatex）或使用wkhtmltopdf；转为Word则只需一条命令。优点：高度可定制、批处理友好；缺点：学习曲线陡峭。

2. Typora —— 所见即所得

Typora提供极简的编辑界面，内置导出功能，可直接导出为PDF和Word（需安装Pandoc）。它适合追求可视化操作的用户。在文件菜单中选择“导出”，即可快速生成带样式的文档。

3. VS Code + 插件

对于开发者，Markdown PDF插件或Markdown All in One配合Pandoc，可在编辑器内完成转换。这种方式便于嵌入现有开发流程，且支持代码高亮。

4. 在线转换工具

如Markdown to PDF、CloudConvert等服务，适合零安装的临时需求。但需注意隐私风险，不宜处理敏感内容。

转换流程与步骤

使用Pandoc将Markdown转为Word

pandoc input.md -o output.docx

此命令会保留标题、列表、表格等基础结构。若要自定义样式，可提供参考文档（reference.docx）：

pandoc input.md --reference-doc=custom-reference.docx -o output.docx

使用Pandoc将Markdown转为PDF

pandoc input.md --pdf-engine=xelatex -o output.pdf

中文字体处理：在YAML头或命令中指定主字体，如mainfont: “SimSun”。亦可用--pdf-engine=weasyprint等替代方案。

Typora导出PDF/Word

点击“文件” → “导出” → 选择“PDF”或“Word”。Typora会自动处理页面布局、目录和代码块样式。注意首次使用Word导出会提示安装Pandoc。

格式优化与常见问题

图片路径处理

若Markdown中引用了本地图片，转换时需保持路径关系。使用Pandoc可设置--resource-path=.，建议将所有图片放在同目录下，并基于相对路径引用。

表格与代码块

复杂表格可能超出PDF页面宽度，可在Pandoc中加入--columns=80或使用LaTeX包调整。代码块建议为长代码启用自动换行，如PDF导出时使用listings或highlighting选项。

TOC与页眉页脚

生成PDF时可利用YAML头设置toc: true，或使用Pandoc的--toc参数。页眉页脚需通过LaTeX模板定制，或使用工具如Prince/WeasyPrint进行CSS控制。

中文字体与编码

转换PDF时，中文显示方块？请在Pandoc的YAML头中添加CJK字体配置，或使用--mainfont="Noto Sans CJK SC"。Word一般无需特别处理，但建议将文档属性中的语言设为中文。

自动化与批处理

对于文档频繁更新的场景，可编写Shell脚本实现批量转换。例如，循环所有*.md文件并输出PDF：

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

在持续集成系统（如GitHub Actions）中，也可嵌入转换命令，实现文档的自动发布。

总结与推荐

对于非技术用户，Typora是最容易上手的方案。对于追求高效率和定制化场景，Pandoc + LaTeX是行业标准。无论选择哪种工具，理解格式差异（如分页机制、CSS支持等）都能帮助你在转换后获得更接近预期的成品。现在就尝试一下，将你的Markdown文档优雅地变成PDF和Word吧！