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 工具 立即體驗。