Pandoc Document Converter

何时触发

关键词命中即触发：转换/格式/md转docx/md转pdf/html/epub/latex/批量导出/幻灯片/文档自动化。

pandoc 是瑞士军刀级别的文档转换工具。

常用转换

Markdown → 其他

# md → docx（Word 文档）
pandoc input.md -o output.docx

# md → pdf（需 LaTeX）
pandoc input.md -o output.pdf

# md → html（独立网页）
pandoc input.md -o output.html --standalone

# md → epub（电子书）
pandoc input.md -o output.epub

其他 → Markdown

# docx → md
pandoc input.docx -o output.md

# html → md
pandoc input.html -o output.md

# pdf → md（需 pdf 解析工具）
pandoc input.pdf -o output.md

批量转换

# 当前目录所有 md → docx
for f in *.md; do pandoc "$f" -o "${f%.md}.docx"; done

实用选项

中文支持（已实测）

推荐字体

Noto Sans CJK SC（已装 noto-fonts-cjk）

中文 PDF 命令

pandoc input.md -o output.pdf --pdf-engine=xelatex \
  -V mainfont="Noto Sans CJK SC" \
  -V CJKmainfont="Noto Sans CJK SC"

或写在 frontmatter：

---
mainfont: Noto Sans CJK SC
CJKmainfont: Noto Sans CJK SC
---

Arch 装中文 PDF 完整 6 件套（踩坑总结）

sudo pacman -S --needed \
  texlive-bin \
  texlive-basic \
  texlive-xetex \
  texlive-latexrecommended \
  texlive-fontsrecommended \
  texlive-langchinese

坑：

1. Arch 拆包：每个包独立装，不会自动依赖链
2. xelatex.fmt 在 /var/lib/texmf/web2c/xetex/，不在主目录
3. **必须装 texlive-xetex**才有 xelatex 格式
4. **必须装 texlive-fontsrecommended**才有 Latin Modern（PDF 默认字体）
5. **必须装 texlive-latexrecommended**才有 fontspec（指定字体的 LaTeX 包）
6. fmtutil.cnf 不自动注册新格式，跑 sudo fmtutil-sys --all 没用——直接装好 xetex 包就有

中文 PDF 故障排查

完整中文 frontmatter 模板

---
title: "文档标题"
author: Mike
date: "2026-08-28"
mainfont: Noto Sans CJK SC
CJKmainfont: Noto Sans CJK SC
CJKmonofont: Noto Sans Mono CJK SC
geometry: margin=2.5cm
toc: true
---

# 正文

何时使用

反 AI 味

转换前先过 masterpiece-writing skill 检查一遍 —— AI 味不会因为格式转换自动消失。

排错