Markdown to PDF: tables, diagrams and equations
Three block types cause most of the damage in a PDF: wide tables, Mermaid diagrams that arrive as images, and equations that depend on fonts. Here is what breaks first and the order to fix it in.
Every published post, grouped by year and by topic — handy when you need an older guide rather than the newest one.
11 articles · 19 topics
Three block types cause most of the damage in a PDF: wide tables, Mermaid diagrams that arrive as images, and equations that depend on fonts. Here is what breaks first and the order to fix it in.
Most repositories accept one PDF/A variant and reject the rest. The difference between 2b and 3b is not quality — it is whether the file may carry attachments.
A thesis skeleton has to decide four things before you write: where chapters break, how sections are numbered, how deep the contents go, and whether the export is tagged. This template decides them in front matter.
A template only helps when the structure is already decided: title page, contents, numbering, page size. These two are plain .md files — download, replace the sample text, export.
A technical document is not hard because it is long. It is hard because prose, code, figures and navigation each break in a different place.
A GitLab repository is not one document — it is a tree of documents at a particular commit. Exporting the wrong ref produces a correct PDF of the wrong release.
A formula that is readable on a 27-inch screen can still be unreadable on A4. The difference is usually not the math, but the size it lands at.
A docs folder is a graph of files, not a single document. Exporting it without breaking the links is most of the work.
A 300-page manual is where a converter either earns trust or falls apart. The first thing readers check is the table of contents.
A table that looks fine in a Markdown preview can still fall apart on an A4 page. Here is what breaks, and what to check before you export.
Most converters screenshot your diagram. Here is what that costs, and how to tell whether a PDF will survive zooming, printing and a failed render.