用途:在 Markdown 与其他 40 多种文档格式之间转换,输出 PDF、DOCX、HTML、LaTeX、演示文稿等。推荐用 Docker 而非本地安装,以避免 LaTeX 依赖问题。
主要能力:pandoc/extra 镜像内置 pandoc、LaTeX(Tectonic)、Eisvogel 模板、Lua 过滤器和开源字体。支持 PDF、DOCX、HTML 转换;PDF 可加 --toc、--number-sections,学术写作可用 --citeproc 处理 BibTeX/CSL 引用;可生成 Beamer(PDF)与 reveal.js(HTML)演示文稿;Eisvogel 模板用于较正式的 PDF 排版。
基本用法:在文档目录运行 docker run --rm --volume "$(pwd):/data" --user $(id -u):$(id -g) pandoc/extra input.md -o output.pdf;也可设别名 pandock 后像 pandoc 一样调用。DOCX 可用 --reference-doc,HTML 可用 --standalone --self-contained。Mermaid 需先用 scripts/mermaid.py 与 Mermaid CLI(mmdc)渲染为图片,再由 Pandoc 嵌入。可用 --defaults=defaults.yaml 复用参数。
适用场景:Markdown 转 PDF/DOCX/HTML、论文引用、幻灯片、批量转换及可重复构建。
限制:Windows 需调整或省略 --user;本地安装仅在无 Docker 时作为后备;Mermaid 需额外安装 Node.js 与 Chromium/Puppeteer;Puppeteer/Chrome 失败时可加 -p assets/mermaid/puppeteer.json;转换前可用 scripts/validate.py 检查。具体收费、价格等信息暂未提供。