Markdown 转 PDF 完全指南

Markdown 以极简的纯文本语法广受欢迎，而 PDF 是跨平台、固定排版的「最终交付物」。把二者结合，是写作者、开发者和运营人员的日常需求。本文系统讲清 Markdown 转 PDF 的几种做法与取舍。

为什么需要 Markdown 转 PDF

• 写作专注：Markdown 让你只关心内容，不被格式打断。
• 交付稳定：PDF 在任何设备上排版一致，适合合同、简历、文档。
• 可版本化：源文件是纯文本，天然适合 Git 管理。

三种主流方案

1. 浏览器打印（最准）

把 Markdown 渲染成 HTML，再用浏览器的「打印 → 另存为 PDF」。优点：样式 100% 一致、零依赖、免费。这正是本工具「打印 / 另存为 PDF」按钮背后的原理。

2. 前端库一键导出（最方便）

使用 html2pdf.js（封装了 html2canvas + jsPDF）把页面直接转成 PDF 文件。优点是点一下就下载，但复杂 CSS（如分页、背景）可能略有偏差。

3. 命令行（适合批量）

如 pandoc、mdpdf、weasyprint。适合在 CI 中批量生成，但要装环境。

排版最佳实践

1. 用 @page { size: A4; margin: 16mm; } 控制打印边距。
2. 代码块用等宽字体并保留配色，提升可读性。
3. 长表格用 pagebreak 规则避免被截断。
4. 避免把内容写死像素宽度，让 PDF 自适应页面。

小结

追求绝对一致用浏览器打印；追求一键下载用前端库。本工具两种都给你准备好了——左侧写 Markdown，右侧实时预览 A4 样式，导出即可。

想要试试？打开首页的 Markdown 转 PDF 工具 立即体验。