How to add a cover page to a Markdown PDF

Picking the right cover layout

• **centered** - title centred mid-page, metadata below. Polished pitch deck or proposal.
• **side-bar** - accent stripe on the left, title beside. Modern internal report.
• **rule** - title near the top, dashed-rule metadata block at the bottom. Classic corporate proposal.
• **block** - title in a tinted block at the top. Bold launch document, newsletter.
• **letter** - sender / recipient / date layout. Use only for formal letters.

Cover page fields explained

• **Title** - main heading, set in the Document section.
• **Subtitle** - one-line description, also in the Document section.
• **Created for** - recipient name and address. The 'rule' and 'side-bar' layouts show this in the metadata block; 'letter' uses it as the recipient block.
• **Created by** - sender name and address.
• **Date** - defaults to today; can be edited in the Document section.
• **Version** - small string like '1.0' or 'INV-2026-019'.
• **Author** - the document author (a person, distinct from 'Created by' which is usually a studio or organisation).

Hiding the cover from page numbering

The cover page is page 1 of the PDF but is excluded from the visible numbering by default. The first body page reads '1 / N'. This matches reader expectations - the cover doesn't 'count'.

If you want the cover to count, you'd have to modify the export post-hoc; the converter doesn't expose a setting for this.