Extended CE: Pandoc Conversion

Pandoc Conversion

You can import Word documents and Markdown files into Overleaf CE+, and export your project to any of these formats, as well as HTML. For details, refer to the Overleaf documentation.

This feature is present in the upstream Overleaf CE, but it is marked as experimental and is not enabled by default.

To enable it in CE+, define the following environment variables:

ENABLE_PANDOC_CONVERSIONS=true
PANDOC_IMAGE=pandoc-ol:3.10.0.0

The second variable specifies the Docker image used for file conversion. Unfortunately, the official Pandoc image from Docker Hub cannot be used directly. Overleaf requires the image to include the zip package and to have an empty entrypoint. You therefore need to build a compatible image yourself using the following (or a similar) Dockerfile:

FROM pandoc/core:3.10.0.0-ubuntu

ENTRYPOINT []

RUN apt update \
 && apt install -y zip \
 && rm -rf /var/lib/apt/lists/*

Build the image with:

docker build -t pandoc-ol:3.10.0.0 .

Alternatively, you can download a prebuilt image from Docker Hub:

docker pull overleafcep/pandoc-ol:3.10.0.0

You can also install pandoc and zip into any Docker image that you use for LaTeX compilation and use that image for Pandoc conversion.

If you do not use Sandboxed Compiles, simply install the pandoc and zip packages in your sharelatex image.