pandoc/extra 在官方 pandoc 基础上扩展 TeX Live 与 lua-filter，支持 PDF 排版与复杂模板渲染。典型集成于文档站点 CI 生成 PDF 手册或电子书，定位为 docker run --rm CLI 工具，非 Web 服务；K8s 场景使用 Job 触发转换而非 Deployment。

快速启动

docker run --rm \
  -v $(pwd):/data \
  docker.io/pandoc/extra:latest \
  pandoc /data/input.md -o /data/output.pdf

推荐实践

docker run --rm \
  -v $(pwd):/data:ro \
  -v $(pwd)/out:/out \
  docker.io/pandoc/extra:3.5 \
  pandoc /data/report.md --template=/data/template.tex \
    -o /out/report.pdf --pdf-engine=xelatex

核心参数说明

• -v ...:/data — 源 Markdown/资源只读挂载
• -v .../out:/out — PDF/HTML 输出目录
• --pdf-engine=xelatex — 中文 PDF 排版引擎
• 定位 — CI/本地 --rm 转换
• 固定 tag — Pandoc/TeX 版本 pin
• 非 — 常驻在线服务