pandoc/extra Docker 镜像 - 轩辕镜像

Pandoc extra 镜像

这些镜像包含 pandoc（通用文档转换器）及以下精选组件：

• 模板：Eisvogel
• Beamer 主题：Eisvogel、beamer-metropolis
• Pandoc 过滤器：pandoc-latex-environment + Lua 过滤器、pandoc-include
• 开源字体：Font Awesome、Source Code Pro、Source Sans Pro
• PDF 引擎：Tectonic

快速参考

• 获取帮助：pandoc-discuss 邮件列表
• 报告问题：[***]
• 源码仓库：pandoc/dockerfiles（GitHub）
• 维护者：Albert Krewinkel、Caleb Maclennan、Damien Clochard

支持的标签

• edge
• 3.7.0.2、3.7.0、3.7、3、latest
• 3.6.4.0、3.6.4、3.6
• 3.5.0.0、3.5.0、3.5
• 3.2.1.0、3.2.1、3.2

同一项目符号中的标签均指向同一镜像。数值标签为滚动更新类型：版本标签始终指向带有指定前缀的最新镜像（如 a.b. 前缀可匹配该版本系列的所有更新）。若需固定镜像版本，需使用完整四段式版本号（如 a.b.c.d）。

latest 标签对应最新发布版本（pandoc 版本发布与镜像更新可能存在短暂延迟）；edge 标签提供最新开发版本。所有标签均可添加堆栈标识符作为后缀（如指定操作系统）。

关于 Pandoc 版本控制的说明

Pandoc 同时作为 Haskell 库开发，版本遵循 Haskell 包版本政策。即使小版本更新（API 未变更），也可能引入新行为，但此类情况极少发生。

支持的堆栈

所有标签均可添加堆栈标识符后缀（如 latest-ubuntu），用于指定操作系统。当前支持：

• alpine：Alpine Linux（默认堆栈）
• ubuntu：Ubuntu Linux

运行 Pandoc Docker 容器

基础用法

以下命令可将当前目录的 README.md 转换为 outfile.epub（为可读性添加换行）：

sh
docker run --rm \
       --volume "$(pwd):/data" \  # 映射本地目录到容器内 /data
       --user $(id -u):$(id -g) \  # 指定本地用户 ID，避免权限问题
       pandoc/extra README.md -o outfile.epub

注意：Docker 选项（如 --volume）需放在镜像名 pandoc/extra 之前，pandoc 参数（如 -o）放在镜像名之后。

便捷别名

若需频繁使用，可设置 shell 别名：

sh
alias pandock='docker run --rm -v "$(pwd):/data" -u $(id -u):$(id -g) pandoc/extra'

之后直接通过 pandock 源文件.md -o 输出文件.pdf 调用。

其他 Pandoc 镜像

除 pandoc/extra 外，还提供以下专用镜像：

• pandoc/minimal：仅含 pandoc 可执行文件的轻量镜像
• pandoc/core：基于 minimal，增加转换常用工具
• pandoc/latex：支持通过 LaTeX 生成 PDF
• pandoc/typst：集成 Typst 排版系统
• pandoc/extra：基于 latex 镜像，增加 Tectonic 引擎、Eisvogel 模板等扩展工具

通过选择合适的镜像，可满足从简单格式转换到复杂 PDF 排版的多样化需求。