MD to PDF · XeLaTeX + 宋体

将 Markdown 文件用 XeLaTeX 渲染为排版级 PDF，使用 macOS 系统自带 Songti SC（宋体-简）作为正文字体。

依赖检查

渲染前确认以下工具可用：

# XeLaTeX（BasicTeX 或 MacTeX）
which xelatex || find /Library/TeX -name xelatex 2>/dev/null

# pandoc
which pandoc

# Songti SC 字体
fc-list :lang=zh | grep -i song

• XeLaTeX 路径：BasicTeX 默认为 /Library/TeX/texbin/xelatex，不在默认 PATH 中，需显式指定。
• 字体：Songti SC 在 macOS 系统自带（/System/Library/Fonts/Supplemental/Songti.ttc），无需额外安装。
• 包依赖（BasicTeX 已含）：fontspec、geometry、hyperref、longtable、booktabs、array、calc、xcolor。

工作流

Step 1：定制模板

从 references/songti-template.tex 读取模板，修改 \title{} 和 \author{} 为目标文档的标题和作者。模板中其他设置（页边距 2.5cm、行距 1.8、A4、11pt）保持不变，除非用户另有要求。

可选自定义项：

• \setmainfont{Songti SC} → 可改为 STSong（华文宋体）、SimSun 等
• \renewcommand{\baselinestretch}{1.8} → 行距
• geometry{margin=2.5cm} → 页边距

Step 2：Pandoc 生成 .tex

pandoc "输入文件.md" -o "/tmp/输出文件名.tex" --standalone \
  --template=/path/to/songti-template.tex

Step 3：XeLaTeX 两遍编译

XELATEX=/Library/TeX/texbin/xelatex  # 或 which xelatex
$XELATEX -output-directory=/tmp -interaction=nonstopmode "/tmp/输出文件名.tex"
$XELATEX -output-directory=/tmp -interaction=nonstopmode "/tmp/输出文件名.tex"

第二遍用于解决交叉引用（标签、目录等）。

Step 4：输出

将 /tmp/输出文件名.pdf 复制到目标目录（默认与源 .md 同目录同名 .pdf）。

模板关键设置说明

已知问题

• BasicTeX 是 Minimal 安装：xeCJK、ctex、enumitem、setspace 等包不包含在内。本模板仅使用 BasicTeX 自带的包，因此不依赖 xeCJK——中文断行通过 XeTeX 原生命令 \XeTeXlinebreaklocale "zh" 实现。
• tlmgr 需要 sudo：如需安装额外 LaTeX 包，用户需自行 sudo tlmgr install <package>。
• macOS Only：模板字体 Songti SC 是 macOS 系统字体，其他平台需替换为对应宋体名称（如 Linux 的 Noto Serif CJK SC、Windows 的 SimSun）。