Markdown headings become PDF section headings and can feed the table of contents.
Paragraphs and lists
Kept
Normal paragraphs, bullets, and numbered lists render as fixed PDF text.
Code blocks
Kept
Fenced code blocks render with code highlighting supported by the document engine path.
Math
Kept
KaTeX-style inline and display math is converted through our PDF renderer, not LaTeX.
Mermaid diagrams
Lost
Mermaid fences are not rendered; convert diagrams to images first if they must appear.
Raw HTML and CSS
Changed
Our document engine may interpret simple inline HTML, but browser CSS is not applied to the PDF.
Page geometry
Changed
Page size, margins, and TOC are controlled by conversion options rather than by Markdown itself.
Headings Kept
Markdown headings become PDF section headings and can feed the table of contents.
Paragraphs and lists Kept
Normal paragraphs, bullets, and numbered lists render as fixed PDF text.
Code blocks Kept
Fenced code blocks render with code highlighting supported by the document engine path.
Math Kept
KaTeX-style inline and display math is converted through our PDF renderer, not LaTeX.
Mermaid diagrams Lost
Mermaid fences are not rendered; convert diagrams to images first if they must appear.
Raw HTML and CSS Changed
Our document engine may interpret simple inline HTML, but browser CSS is not applied to the PDF.
Page geometry Changed
Page size, margins, and TOC are controlled by conversion options rather than by Markdown itself.
Sample conversions
Architecture note
Input
3,800-word Markdown architecture note with H2/H3 headings, shell code blocks, one Mermaid diagram, and a requested TOC.
Output
The PDF had a generated TOC, clean headings, and highlighted code. The Mermaid block appeared as code text because this route does not render Mermaid.
Math-heavy handout
Input
6-page Markdown handout with inline variables, display equations, three tables, and A4 margins.
Output
Our PDF renderer rendered the math and tables into a readable A4 PDF. One long equation exceeded the text width and needed a manual line break.
Release notes
Input
Markdown release notes with nested lists, issue links, and screenshots hosted over HTTPS.
Output
Lists and links rendered correctly, and reachable screenshots appeared. A private screenshot URL was omitted because the converter could not fetch it.
A real Markdown → PDF run
We converted our Markdown sample (472 B) with Document engine → PDF renderer on 2026-09-11. It took 49 ms and produced a 21 KB PDF file, 45× larger than the input. The engine raised no warnings.
Variable names and template support can differ from LaTeX examples found online.
Markdown to PDF by API or MCP
The HTTP API and the MCP server run the exact engine this page uses (Document engine → PDF renderer); the response carries the same warnings the web converter shows. Check support first with GET /api/v1/pairs?from=md&to=pdf.