detjensrobert/arch-pandoc repository overview

⁠arch-pandoc-container

⁠See the GitHub repo⁠ for a more up-to-date version of this README.

Ubuntu's version of Pandoc⁠ is old and doesn't like some raw LaTeX macros I use for some classes, and the official pandoc/latex⁠ image does not have all of the needed LaTeX packages for those macros either. This Docker container provides Arch's versions of Pandoc and TeXLive, which work just fine.

Additionally, this bundles MLA, APA, and IEEE CSLs⁠ for citations, along with some Pandoc filters:

• pantable⁠
• pandoc-include⁠

⁠Tags

Images are tagged based on the Pandoc version and the LaTeX engine included.

The :latest tag ships with Tectonic⁠ as the LaTeX engine for a much smaller container size, but may not work for all LaTeX packages.

• :latest
• :<version> (e.g. :1.19.2)
• :<version>-tectonic (e.g. :1.19.2-tectonic)

The :full tag has the more 'standard' TeXLive⁠ installation, but is a much larger container (over 2GB!).

• :full
• :<version>-texlive (e.g. :1.19.2-texlive)

⁠Usage:

Use this as a drop-in for standard pandoc:

docker run --rm -v $(pwd):/data -u $(id -u):$(id -g) detjensrobert/arch-pandoc -s file.md -o file.pdf ...

• This container expects all necessary files to be mounted at /data in the container: -v $(pwd):/data

• To avoid output being owned by root, run the entrypoint as your UID/GID: -u $(id -u):$(id -g)

  NOTE: if using rootless containers, e.g. podman, this is not needed! root in the container is already mapped to your normal user.

  NOTE 2: If this causes permission errors with a Tectonic image, try switching to the TeXLive image instead.

Add this shell function to your shell config for convenience:

pandoc-docker () {
  docker run --rm -v $(pwd):/data -u $(id -u):$(id -g) detjensrobert/arch-pandoc $@
}

md2pdf-docker () {
  pandoc-docker -s "$1" -o "${1%%.md}.pdf" -V geometry:margin=1in --highlight=tango --citeproc ${@:2}
}

# usage:
md2pdf-docker some-document.md --filter pantable  # -> creates some-document.pdf