Markdown 轉 PDF:免安裝 3 種方法
寫好的 Markdown 要交報告、寄給客戶或印出來,最常見的需求就是轉成 PDF。這篇整理 3 種做法,從「打開網頁就能轉」到「用指令批次轉換」都有。
最快的方法: 用墨閱開啟 .md 檔,按工具列的「列印/另存 PDF」,選擇「另存為 PDF」就完成了。
方法 1:墨閱線上轉 PDF(免安裝,推薦)
適合大多數人:不用裝軟體,圖表和公式都會保留,中文也不會變成方框。
- 打開墨閱,把
.md檔拖進視窗。若檔案有引用圖片,請改用「開啟資料夾」。 - 按右上角工具列的「列印/另存 PDF」(下載圖示)。
- 在列印視窗的「目的地」選擇 另存為 PDF,按「儲存」。
建議的列印設定:
| 設定 | 建議值 | 原因 |
|---|---|---|
| 紙張大小 | A4 | 墨閱已針對 A4 排版 |
| 邊界 | 預設 | 墨閱已預留 16 mm 邊界 |
| 頁首和頁尾 | 取消勾選 | 避免印出網址與日期 |
| 背景圖形 | 勾選 | 保留程式碼區塊與表格底色 |
墨閱匯出時會自動:
- 把 Mermaid 圖表與 LaTeX 公式改用適合列印的淺色配色。
- 隱藏側欄、目錄與工具列,只留下內容。
- 避免標題落在頁尾、程式碼區塊與表格列被切成兩半。
沒有檔案、只有一段文字? 打開 Markdown 線上編輯器貼上內容,一樣可以另存 PDF。
方法 2:Visual Studio Code
如果你本來就用 VS Code 寫 Markdown:
- 在擴充功能搜尋並安裝 Markdown PDF。
- 開啟
.md檔,按Ctrl + Shift + P,輸入「Markdown PDF: Export (pdf)」。 - PDF 會存在同一個資料夾。
缺點是 Mermaid 圖表與數學公式需要另外設定,中文字型也可能要調整。
方法 3:Pandoc(適合批次轉換)
Pandoc 是文件格式轉換的專業工具,適合工程師或要大量轉檔的人。安裝 Pandoc 與 LaTeX 引擎(例如 MiKTeX、TeX Live)後執行:
pandoc input.md -o output.pdf --pdf-engine=xelatex -V CJKmainfont="Microsoft JhengHei"
--pdf-engine=xelatex才能正確處理中文。CJKmainfont要換成電腦裡有的中文字型,Mac 可用"PingFang TC"。- Mermaid 圖表需要額外的過濾器,設定較複雜。
三種方法比較
| 墨閱 | VS Code | Pandoc | |
|---|---|---|---|
| 需要安裝 | 不用 | 要 | 要(含 LaTeX) |
| 中文 | 直接正常 | 可能要調字型 | 要指定字型 |
| Mermaid 圖表 | 支援 | 需設定 | 需外掛 |
| 數學公式 | 支援 | 需設定 | 支援 |
| 批次轉換 | 不適合 | 不適合 | 適合 |
常見問題
PDF 裡的圖片不見了?
在墨閱請用「開啟資料夾」,讓圖片和 .md 檔一起被讀取;只開單一檔案時找不到旁邊的圖片。
可以控制分頁位置嗎?
墨閱會自動避免不好的分頁。如果想在某處強制換頁,目前建議把文件拆成兩份分別匯出。
手機可以轉 PDF 嗎?
可以。用手機瀏覽器開啟墨閱,按「列印/另存 PDF」,iPhone 在分享選單選「列印」後再存成 PDF,Android 則在列印目標選「儲存為 PDF」。詳細步驟可參考手機開啟 md 檔教學。
想轉成 Word?
先依上面的方法存成 PDF,再用 Word 開啟 PDF 即可轉換;或使用 Pandoc:pandoc input.md -o output.docx。