Markdown 轉 PDF:免安裝 3 種方法

寫好的 Markdown 要交報告、寄給客戶或印出來,最常見的需求就是轉成 PDF。這篇整理 3 種做法,從「打開網頁就能轉」到「用指令批次轉換」都有。

最快的方法: 用墨閱開啟 .md 檔,按工具列的「列印/另存 PDF」,選擇「另存為 PDF」就完成了。

方法 1:墨閱線上轉 PDF(免安裝,推薦)

適合大多數人:不用裝軟體,圖表和公式都會保留,中文也不會變成方框。

  1. 打開墨閱,把 .md 檔拖進視窗。若檔案有引用圖片,請改用「開啟資料夾」。
  2. 按右上角工具列的「列印/另存 PDF」(下載圖示)。
  3. 在列印視窗的「目的地」選擇 另存為 PDF,按「儲存」。

建議的列印設定:

設定 建議值 原因
紙張大小 A4 墨閱已針對 A4 排版
邊界 預設 墨閱已預留 16 mm 邊界
頁首和頁尾 取消勾選 避免印出網址與日期
背景圖形 勾選 保留程式碼區塊與表格底色

墨閱匯出時會自動:

  • 把 Mermaid 圖表與 LaTeX 公式改用適合列印的淺色配色。
  • 隱藏側欄、目錄與工具列,只留下內容。
  • 避免標題落在頁尾、程式碼區塊與表格列被切成兩半。

沒有檔案、只有一段文字? 打開 Markdown 線上編輯器貼上內容,一樣可以另存 PDF。

方法 2:Visual Studio Code

如果你本來就用 VS Code 寫 Markdown:

  1. 在擴充功能搜尋並安裝 Markdown PDF。
  2. 開啟 .md 檔,按 Ctrl + Shift + P,輸入「Markdown PDF: Export (pdf)」。
  3. 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。