使用 Pandoc 將含中文的 MarkDown 檔案轉換成 PDF 文件

📌 Introduction

分享使用 Pandoc 將 Markdown 檔案轉換成 LaTeX 格式的 PDF 文件。

🗒️ Notes

需要在 Markdown 檔案的最前面(原本檔案的第一行前面)加入以下註釋(包含前後的 ---)。

以下範例使用 macOS 內的預設字型「蘋方體」(PingFang SC)，若是在其他作業系統上使用請選擇已安裝的字型。｀

---
header-includes:
  - \usepackage{fontspec}
  - \setmainfont{PingFang SC}  # Or another CJK-supporting font installed on your system
  - \XeTeXlinebreaklocale "zh"   # Set line breaks for Chinese
  - \XeTeXlinebreakskip = 3pt plus 1pt
  - \usepackage{geometry}
  - \geometry{top=1in, inner=1in, outer=1in, bottom=1in, headheight=3ex, headsep=2ex}
---

轉換成 PDF 的 Pandoc 指令

$ pandoc -o test.pdf --pdf-engine=xelatex test.md