Markdown 轉 PDF

用 pandoc 把 Markdown 轉成漂亮的 PDF。從此擺脫 Microsoft Word 和 LibreOffice 等等肥大的文書處理軟體！

字體設定

在 Markdown 檔案中，可以使用 mainfont 在 YAML 前言區塊設定主要字體：

---
mainfont: \"PingFang TC\"
---

記得字體名稱如果有空格，要用 \" 把它包起來。

PDF 轉換引擎

轉換為 PDF 時，推薦使用 WeasyPrint 引擎。它好裝、方便、漂亮；因為是基於 HTML/CSS，所以沒有 LaTeX 的一堆麻煩問題。

使用 WeasyPrint 的方法：

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

強制分頁技巧

在 Markdown 檔案中的 YAML 前言中加入 CSS 樣式：

---
header-includes: |
    <style>
    h1 {
        break-before: page;
    }
    </style>
---

這樣轉 PDF 時，就會自動在 H1 標題前分頁。

完整範例

以下是一個結合字體設定和強制分頁的 Markdown 範例：

---
mainfont: \"PingFang TC\"
header-includes: |
    <style>
    h1 {
        break-before: page;
    }
    </style>
---

# 這是一個標題

裡面寫了一些字

## 這是二號標題

裡面也寫了一些字

# 這個一號標題會在新頁（轉 PDF 的話）

這是一些字

使用以下指令將 Markdown 文件轉換為 PDF：

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

當然，要記得先裝好 pandoc 和 weasyprint。