pandoc/typst

Pandoc Typst 镜像

这些镜像包含 pandoc（通用文档转换器）和 Typst（快速且现代的排版系统，可用于生成PDF）。

快速参考

• 获取帮助：pandoc-discuss 邮件列表
• 报告问题：https://github.com/pandoc/dockerfiles/issues
• 源代码仓库：https://github.com/pandoc/dockerfiles%EF%BC%88GitHub%EF%BC%89
• 维护者：https://github.com/tarleb%E3%80%81https://github.com/alerque 和 https://github.com/daamien

支持的标签

• edge
• 3.9.0.0、3.9.0、3.9、3、latest
• 3.8.3、3.8
• 3.7.0.2、3.7.0、3.7

同一项目符号中的标签均指向同一镜像。数值标签为滚动更新型，即版本标签始终指向具有指定版本前缀的最新镜像。前缀版本（如 a.b.）是指定可接受版本范围的简便方式。使用完整的四部分版本（如 a.b.c.d）可将镜像固定到特定版本。

latest 标签指向最新发布的版本；pandoc 版本发布与新镜像发布之间可能存在轻微延迟。

edge 标签提供最新的开发版本。

所有标签均可添加堆栈标识符作为后缀。

关于 pandoc 版本控制的说明

pandoc 不仅是可执行文件，还是 Haskell 库，因此其版本遵循 Haskell 包版本政策。即使次要版本在 API 不变的情况下有时也可能引入新行为，但这种情况很少见。

支持的堆栈

所有标签均可添加堆栈标识符作为后缀，例如 latest-ubuntu，以选择特定操作系统。可用堆栈包括：

• alpine：Alpine Linux
• ubuntu：Ubuntu Linux

pandoc/typst 的默认堆栈为 alpine。

运行 pandoc Docker 容器

镜像的常见使用方式如下（为可读性添加换行）：

sh
docker run --rm \
       --volume "$(pwd):/data" \
       --user $(id -u):$(id -g) \
       pandoc/typst README.md -o outfile.epub

此命令会将当前工作目录中的 README.md 文件转换为 outfile.epub。注意，Docker 选项位于镜像名称（此处为 pandoc/typst）之前，而 pandoc 选项位于镜像名称之后。

--volume 标志将本地目录（冒号左侧）映射到容器中的目录（冒号右侧），使 pandoc 可访问源文件。$(pwd) 被引用以避免文件名中的空格问题。

输出文件的所有权由容器中执行 pandoc 的用户决定，该用户通常与本地用户不同。因此，建议通过 --user 标志为 Docker 指定要使用的用户和组 ID。

对于频繁的命令行使用，建议使用以下 shell 别名：

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

使用 pandoc 选项 --pdf-engine=typst 可通过 Typst 生成 PDF。

其他镜像

以下 pandoc 镜像可用：

• https://hub.docker.com/r/pandoc/minimal%EF%BC%9A%E5%8C%85%E5%90%AB pandoc 可执行文件的小型镜像
• https://hub.docker.com/r/pandoc/core%EF%BC%9A%E5%9F%BA%E4%BA%8E minimal 镜像，包含转换过程中常用的其他程序
• https://hub.docker.com/r/pandoc/latex%EF%BC%9A%E9%80%82%E7%94%A8%E4%BA%8E%E9%80%9A%E8%BF%87 LaTeX 转换为 PDF
• https://hub.docker.com/r/pandoc/extra%EF%BC%9A%E5%9F%BA%E4%BA%8E pandoc/latex 的大型镜像，包含更多辅助工具、Tectonic 引擎和 https://github.com/Wandmalfarbe/pandoc-latex-template
• https://hub.docker.com/r/pandoc/typst%EF%BC%9A%E5%8C%85%E5%90%AB Typst 排版系统