Markdown to PDF

An opinionated, zero-configuration Docker container for converting Markdown to beautiful PDFs using Pandoc with optimized settings.

• Zero configuration - Just works out of the box
• Optimized defaults - Community-tested settings for best output
• Full featured - Emoji, Mermaid diagrams, math, code wrapping
• Beautiful output - Choose Eisvogel (professional) or GitHub-flavored styling
• Simple usage - Upload and convert through a web UI

Features

• PDF Engine: LuaLaTeX (full Unicode and color emoji support)
• Templates: Eisvogel (professional, technical documentation) or GitHub-flavored markdown styling
• Typography: DejaVu font family with Noto Color Emoji fallback
• Diagrams: Mermaid, Graphviz, PlantUML, TikZ via diagram.lua filter
• Code: Syntax highlighting (Tango) with automatic line wrapping
• Layout: A4 paper with 2cm margins, auto table of contents, numbered sections
• Markdown: Task lists, tables, footnotes, strikethrough, superscript/subscript, math

Quick Start

git clone https://github.com/spenpal/markdown-to-pdf.git
cd markdown-to-pdf
docker compose up

Open http://localhost:8501, upload a Markdown file, and choose a PDF style (Eisvogel or GitHub).

Run in background:

docker compose up -d

Rebuild after changes:

docker compose up --build

Stop:

docker compose down

Requirements

• Docker

License

MIT License - see LICENSE file for details.