pandoc/minimal

pandoc 最小化镜像

镜像概述与主要用途

本镜像包含pandoc——通用文档转换器，旨在提供精简的部署方案。容器已尽可能精简："static"镜像仅包含静态编译的pandoc二进制文件，其他镜像则额外包含最小化的操作系统环境。

核心功能与特性

• 精简镜像体积：静态编译版本（static）仅包含pandoc可执行文件，无额外系统依赖；其他版本基于最小化操作系统（Alpine/Ubuntu）构建。
• 版本灵活控制：支持多版本标签（如3.7.0、3.7等），满足不同版本锁定需求。
• 多操作系统支持：提供static（默认）、Alpine、Ubuntu三种基础环境堆栈，适配不同场景。
• 开发版本支持：通过edge标签提供最新开发版，便于测试前沿功能。

使用场景与适用范围

适用于需要轻量级pandoc环境的文档转换场景，例如：

• Markdown/HTML/LaTeX等格式间的文档转换（如生成EPUB、MOBI等）。
• CI/CD流程中集成文档转换步骤，需控制镜像体积以提升效率。
• 对系统资源敏感的环境，或仅需pandoc核心功能无需额外依赖的场景。

快速参考

• 获取帮助：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%E3%80%81https://github.com/daamien

详细使用指南

支持的标签

以下标签均指向同一镜像，数值标签为滚动更新（即版本前缀标签始终指向该前缀下的最新镜像）：

• 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.）可指定版本范围（例：3.7.包含3.7.0.2及后续小版本）。
  • 完整四部分版本（如a.b.c.d）可锁定至具体版本（例：3.7.0.2）。
  • latest标签指向最新发布版本，版本发布后可能存在短暂延迟更新。

pandoc 版本说明

pandoc既是可执行程序也是Haskell库，版本遵循Haskell包版本策略。即使小版本号更新，若API未变更，可能引入新行为（但此情况罕见）。

支持的环境堆栈

所有标签可添加堆栈标识符后缀（如latest-ubuntu），指定基础操作系统环境。支持的堆栈：

• static（默认）：静态编译的pandoc二进制文件，基于scratch镜像（无操作系统）。
• alpine：基于Alpine Linux，轻量级Linux发行版。
• ubuntu：基于Ubuntu Linux，兼容性更广泛的Linux发行版。

运行容器

基础命令示例

将当前目录下的README.md转换为outfile.epub：

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

参数说明：

• --rm：容器运行结束后自动删除。
• --volume "$(pwd):/data"：将本地当前目录挂载至容器内/data目录，使pandoc可访问源文件。
• --user $(id -u):$(id -g)：指定容器内运行用户ID（UID）和组ID（GID），避免输出文件权限问题。
• 命令顺序：Docker选项（如--rm、--volume）需置于镜像名（pandoc/minimal）前，pandoc参数（如README.md -o outfile.epub）需置于镜像名后。

频繁使用优化

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

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

设置后可直接通过pandock命令调用，例如：

sh
pandock README.md -o outfile.pdf

相关镜像

除pandoc/minimal外，还提供以下扩展镜像：

• https://hub.docker.com/r/pandoc/core%EF%BC%9A%E5%9F%BA%E4%BA%8Eminimal%E9%95%9C%E5%83%8F%EF%BC%8C%E5%8C%85%E5%90%AB%E6%96%87%E6%A1%A3%E8%BD%AC%E6%8D%A2%E5%B8%B8%E7%94%A8%E8%BE%85%E5%8A%A9%E5%B7%A5%E5%85%B7%E3%80%82
• https://hub.docker.com/r/pandoc/latex%EF%BC%9A%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87LaTeX%E8%BD%AC%E6%8D%A2%E4%B8%BAPDF%E3%80%82
• https://hub.docker.com/r/pandoc/extra%EF%BC%9A%E5%9F%BA%E4%BA%8Elatex%E9%95%9C%E5%83%8F%EF%BC%8C%E5%8C%85%E5%90%AB%E6%9B%B4%E5%A4%9A%E5%B7%A5%E5%85%B7%E3%80%81Tectonic%E5%BC%95%E6%93%8E%E5%8F%8Ahttps://github.com/Wandmalfarbe/pandoc-latex-template%E3%80%82
• https://hub.docker.com/r/pandoc/typst%EF%BC%9A%E9%9B%86%E6%88%90Typst%E6%8E%92%E7%89%88%E7%B3%BB%E7%BB%9F%E3%80%82