The Markdown to PDF guides
Better documents start with
a better export.
Practical field notes for turning Markdown into clean, readable PDFs. Tables, code blocks and page breaks — considered before you hit export.
Explore the guides ↓The reference desk
11 guides. From preparation to final check.
Markdown to PDF without broken tables, code or page breaks
A practical pre-export and PDF inspection workflow for Markdown documents, including a small test fixture and troubleshooting checklist.
Mermaid diagrams that stay readable in a PDF
A page-first workflow for Mermaid flowcharts in Markdown: orientation, short labels, accessible titles and a final PDF legibility check.
LaTeX math in Markdown that survives the PDF
A pre-export workflow for inline and display equations, including a small sampling fixture and a PDF inspection pass for roots, fractions and limits.
GitHub alerts in Markdown: callouts that work on paper
How to choose, write and check GitHub alert callouts so a printed PDF keeps the warning visible without turning every page into a colour block.
Sending a README as a PDF: what breaks when the repository is gone
A pre-export checklist for turning a repository README into a PDF: relative images and links, badges, issue references and the provenance a detached file needs.
Footnotes in a Markdown PDF: expect endnotes
Where Markdown footnotes actually land in a PDF, how numbering and back-links behave, and when to move a note into the body instead.
YAML front matter in Markdown: name the PDF, show the context
How front matter becomes a printed properties panel, how its title names the downloaded PDF, and which fields you should never put there.
Task lists in a Markdown PDF: printed checkboxes, not a form
What task-list checkboxes become in an exported PDF, how nested and table cases behave, and when a checklist needs status in words instead.
GitHub issue links in a Markdown PDF: cards vs plain URLs
How bare GitHub and GitLab links become reference cards in an exported PDF, what metadata they freeze, and when a plain link is the better choice.
Raw HTML in a Markdown PDF: what prints, what hides
How raw HTML behaves on export, why a closed details section can vanish from the PDF, and which inline elements still print.
Images in a Markdown PDF: size, resolution and alt text
How image width changes printed resolution, why a broken path prints alt text, and how to check figures and screenshots in the exported PDF.