How-to

Markdown to PDF with page numbers

Page numbers are the small chrome that makes a document feel finished. They cost almost nothing to add and instantly say 'this is a real document'.

·2 min read
Open the converter

What page numbers look like in this tool

Bottom-center, monospaced (Space Mono or the active font family's mono pair), 8.5pt, in the theme's tertiary ink colour. The format is '1 / N' - current page over total. We use a slash because it's unambiguous in any locale.

The mono face is intentional: it doesn't compete with the body type for visual weight, and the number-glyph widths line up across pages.

Cover and ToC excluded by default

If your document has a cover page, the cover is page 1 of the PDF but is excluded from the visible numbering. The first body page reads '1 / N' - which is what most readers expect for a serious document.

Same for the Table of Contents page: included in the document but skipped in the count.

Adding a footer text alongside

The Footer text field in the Page section adds a left-aligned footer string on every body page (e.g. 'Confidential' or 'Internal - do not distribute'). It coexists with the centered page number - left for the label, center for the number.

FAQ

Can I change the page number position?

Not via a setting in v1. Bottom-center is the convention for body pages and we picked it as the default. If you need bottom-right or top-center, the change request is small - open an issue.

Why does my page count include the cover?

It shouldn't. If your document shows '2 / 12' on the first body page, the cover toggle was probably off when you exported (the body counts from page 1 in that case). Turn the cover toggle on and re-export.

Page numbers don't print - what's wrong?

Open the Page section in the sidebar and check the 'Show page numbers' toggle is on. The toggle is on by default in most templates but off for invoices and resumes (where page numbers are usually unwanted).

Related

https://md2document.com/markdown-to-pdf-with-page-numbers/