pandoc/minimal

Minimal pandoc images

These images contain https://pandoc.org/, the universal document converter. Containers are stripped down to a bare minimum as far as sensible: The “static” images contain only a statically compiled pandoc binary, whereas the other images also contain a minimal operating system.

Quick Reference

• Where to get help: https://groups.google.com/forum/#!forum/pandoc-discuss

• Where to report issues: https://github.com/pandoc/dockerfiles/issues

• Source repository: https://github.com/pandoc/dockerfiles on Github

• Maintained by: https://github.com/tarleb, https://github.com/alerque, and https://github.com/daamien.

Supported tags

• edge
• 3.11.0.0, 3.11.0, 3.11, 3, latest
• 3.10.0.0, 3.10.0, 3.10
• 3.9.0.2, 3.9.0, 3.9
• 3.9.0.0
• 3.8.3, 3.8
• 3.7.0.2, 3.7.0, 3.7

The tags listed in a bullet point all refer to the same image. Numerical tags are rolling, meaning that a version tag always points to the newest image with the given version prefix. A prefix-version like a.b. is an easy way to specify a range of acceptable versions. Use a full, four part version like a.b.c.d to fix the image to a specific version.

The latest tag refers to the most recently released version; there may be a minor lag between the time a pandoc version is released and a new image is released.

A recent development version is provided under the edge tag.

All tags can be suffixed with a stack identifier.

A note on pandoc versioning

Pandoc is not only an executable but also a Haskell library, which is why it is versioned using the [***] Even minor versions can sometimes introduce new behavior if the API does not change, but this is a rare occasion.

Supported stacks

All tags can be suffixed with a stack-identifier, e.g., latest-ubuntu. This allows to chose a specific operation system. Available stacks are

• static: statically compiled binary, wrapped in a scratch image.
• alpine: https://alpinelinux.org/ Linux.
• debian: https://debian.org/ Linux.
• ubuntu: Ubuntu Linux.

The default for pandoc/minimal is static.

Run the pandoc Docker container

A common use of the image looks like this (linebreaks for readability):

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

This will convert the file README.md in the current working directory into outfile.epub. Note that Docker options go before the image name, here pandoc/minimal, while pandoc options come after it.

The --volume flag maps some local directory (lefthand side of the colons) to a directory in the container (righthand side), so that you have your source files available for pandoc to convert. $(pwd) is quoted to protect against spaces in filenames.

Ownership of the output file is determined by the user executing pandoc in the container. This will generally be a user different from the local user. It is hence a good idea to specify for docker the user and group IDs to use via the --user flag.

For frequent command line use, we suggest the following shell alias:

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

Other images

The following pandoc images are available:

• https://hub.docker.com/r/pandoc/minimal: small images with the pandoc executable.
• https://hub.docker.com/r/pandoc/core: based on minimal images and includes additional programs that are commonly used during conversions.
• https://hub.docker.com/r/pandoc/latex: suitable for conversions to PDF via LaTeX.
• https://hub.docker.com/r/pandoc/extra: large images based on the pandoc/latex, with more helpers, the Tectonic engine, and the https://github.com/Wandmalfarbe/pandoc-latex-template
• https://hub.docker.com/r/pandoc/typst: includes the https://typst.app/ typesetting system.