md2pdf

通过 Pandoc + XeLaTeX 将 Markdown 转换为 PDF。支持完整 LaTeX 数学公式和中文/日文/韩文（CJK）。

前置条件

系统软件包（apt）：

pandoc texlive-xetex texlive-fonts-recommended texlive-fonts-extra texlive-latex-extra texlive-lang-chinese

快速转换

bash
bash <技能目录>/scripts/md2pdf.sh 输入文件.md 输出文件.pdf

该脚本会自动检测 CJK 内容、选择合适的字体、清理表情符号、添加目录，并配置 XeLaTeX。

手动 Pandoc 命令

如需精细控制，可直接运行 pandoc：

bash
pandoc 输入文件.md -o 输出文件.pdf \
--pdf-engine=xelatex \
-f markdown-smart \
-H header.tex \
-V mainfont=DejaVu Sans \
-V monofont=DejaVu Sans Mono \
-V geometry:margin=20mm \
-V fontsize=10pt \
-V colorlinks=true \
--highlight-style=tango \
--toc -V toc-title=目录

其中 header.tex 包含：

latex
\usepackage{xeCJK}
\setCJKmainfont{}

关键细节

• - 数学公式：Pandoc 原生将 $...$（行内）和 $$...$$（独立行）转换为 LaTeX 数学公式，无需 MathJax/KaTeX。
• CJK 字体：脚本自动按以下顺序检测：Noto Sans CJK SC > WenQuanYi Micro Hei > Droid Sans Fallback > AR PL UMing CN。
• 表情符号：由于大多数 LaTeX 字体缺少表情符号字形，会替换为文本等效符号（✅ → [Y]，❌ → [N]，⭐ → *）。
• 智能引号：使用 -f markdown-smart 避免弯引号渲染问题。
• 长表格：Pandoc 可能难以处理复杂表格；建议保持表格简洁，或使用 longtable LaTeX 包。

故障排除