A fast, pure-Rust CLI that converts Markdown to PDF.

• ✅ CommonMark + GFM (tables, strikethrough, task lists, autolinks, footnotes, definition lists, GitHub Alerts, superscript, subscript, underline)
• ✅ Fenced code blocks with Syntect syntax highlighting
• ✅ LaTeX math — $…$ inline and $$…$$ display, plus ```math ``` blocks
• ✅ Remote image caching (http/https → local cache)
• ✅ Data-URI images (data:image/png;base64,…)
• ✅ Auto-generated Table of Contents (via Typst's #outline() — real page numbers)
• ✅ Named page presets: a4, letter, a5, legal, slides
• ✅ Custom body and monospace font families
• ✅ Doctor / self-check mode (--doctor)
• ✅ Read from stdin (-)

./install.sh

Builds the release binary and symlinks it to /usr/local/bin/ditto so it's available globally.

cargo build --release
# Binary is at target/release/ditto

cargo install --path .

ditto [OPTIONS] <INPUT> <OUTPUT>
ditto --doctor

# Basic conversion
ditto README.md README.pdf

# US Letter, 14 pt, custom fonts
ditto --preset letter --font-size 14 \
          --font-family "EB Garamond" --mono-font-family "Fira Code" \
          report.md report.pdf

# Slide deck (16:9)
ditto --preset slides --no-toc slides.md slides.pdf

# TOC — H1 and H2 only
ditto --toc --toc-depth 2 big-doc.md big-doc.pdf

# Dark code theme, skip remote images
ditto --syntax-theme "base16-ocean.dark" --no-remote-images doc.md doc.pdf

# Self-check
ditto --doctor

Built-in syntax themes: InspiredGitHub, base16-ocean.dark, base16-ocean.light, base16-eighties.dark, base16-mocha.dark, Solarized (dark), Solarized (light)

TOC entries are real (Typst #outline() with page numbers and clickable links).
You can also enable/override the TOC from YAML front matter:

---
toc: true
toc_depth: 3
---

ditto --doctor

Runs diagnostics:

• ✅ Typst engine round-trip compile
• ✅/⚠️ Default body and mono font availability
• ✅ Cache directory writability
• ✅/⚠️ Network reachability (for remote images)
• ✅ Rust toolchain info

Exits with code 0 on pass, 1 if any check fails.

YAML front matter (delimited by ---) can override toc and toc_depth:

---
toc: true
toc_depth: 2
---
# My Document

cargo build --release   # release binary → target/release/ditto
cargo test              # full test suite (725+ tests)
cargo clippy            # lint
cargo fmt               # format
cargo run -- test.md output.pdf

Some HTML tags, LaTeX commands, and edge-case Markdown constructs are not fully supported. See docs/known-limitations.md for a comprehensive list, including:

• Which HTML tags are translated and which are stripped
• Which CSS properties on <span> are honoured (color and font-size only)
• Which LaTeX math commands have no Typst equivalent
• GFM features that are unsupported (wikilinks, custom heading IDs, etc.)
• Front-matter keys that are recognised (toc, toc_depth, toc_title, no_toc only)
• Image and typography constraints

MIT OR Apache-2.0