Markdown to PDF

Learn

Custom PDF Templates: Build a Premium Branded Report

Design a dark, full-bleed branded report — wordmark, serif typography, brand colors, and a full-page background — in the custom template builder, then reuse it across the app and the API.

Published May 3, 2026·Updated June 12, 2026

A custom template turns plain Markdown into a document that looks like it came from a design studio — your wordmark, your typography, your colors, edge to edge. Build it once, and every report, proposal, or brief you export afterwards is on-brand in a single click.

This guide walks through one complete example end to end: Aurelia, a dark, full-bleed brand-strategy report of the kind agencies and consultants send to clients who expect the deliverable to feel as considered as the work. Follow the steps and you’ll have your own version saved to your account — and a recipe you can adapt for invoices, pitch decks, statements of work, and more.

A finished Aurelia brand-strategy report: a deep navy full-bleed page with a gold AURELIA wordmark, serif headings, and a cream body.

The finished result — rendered from ordinary Markdown through your saved template.

What you’ll build

Aurelia is deliberately “expensive looking,” and every part of it is something you control in the builder:

  • A full-bleed background — a deep navy gradient that reaches every edge of the page.
  • A gold wordmark masthead and a small, letter-spaced confidentiality line.
  • Serif typography — a high-contrast display face for headings, a refined book serif for body text.
  • A brand palette — warm gold headings, cream body text, a gold-ruled pull quote.
  • Real document structure — an executive summary, a positioning matrix table, and a roadmap — all styled to stay legible on a dark page.

Before you begin

  1. Sign in to your account. The builder lives at Dashboard → Template builder.
  2. A paid plan is recommended. Designing and saving templates is free, but exporting without the watermark — and using a premium base such as Executive — requires a paid plan.
  3. Prepare two assets:
    • A logo or wordmark as a transparent PNG. A wide, short wordmark (for example 1200×170) reads beautifully as a slim masthead.
    • An optional background image sized to A4 portrait (about 1240×1754). A dark, low-contrast gradient or texture works best — busy photos fight your text.

Tip: no background image handy? A solid dark Background color alone still triggers the premium dark styling described below, so you can build the entire template without uploading anything.

Step 1 — Open the builder and name your template

Open Dashboard → Template builder. You’ll see three areas: the Template library on the left, the page canvas in the middle, and the Template inspector on the right, where all editing happens.

In the inspector:

  1. Set Name to Aurelia — Brand Strategy Report.
  2. Add a short Description so you recognize it later.
  3. Set Base template to Executive — a refined base with elegant heading rules and a strong table style.
  4. Tick Set as default template if you’d like it pre-selected in the converter.

The custom template builder: template library on the left, page canvas in the centre, and the inspector on the right.

The three-panel builder. Everything you change in the inspector updates the page instantly.

Step 2 — Add a full-bleed page background

In the inspector, find the Page shell section. This controls the outer page — the part that reaches the paper’s edge.

  1. Under Background image, click Upload background image and choose your dark A4 artwork. It fills the page edge to edge automatically.
  2. Leave the four padding values at 0 — the document already keeps a comfortable margin inside the bleed.
  3. Add a Scrim — a subtle wash over the image that keeps text legible. Set Scrim color to a near-black like #05070F and nudge Scrim strength to roughly 18%.

No image? Set Background color to a deep navy such as #070B18 instead. Either way, the builder recognizes a dark page and automatically cleans up the base template’s light-page touches (the white quote card, zebra-striped table rows, the muted bold accent) so your colors show through cleanly.

The Page shell inspector panel showing a dark background image with a Replace/Remove control and a Scrim strength slider set to 18%.

Page shell: a full-bleed background plus a gentle scrim for legibility.

Still in the inspector, open the Branding section:

  • Brand name: Aurelia
  • Subtitle: Brand Strategy Studio
  • Footer text: Aurelia Brand Studio · Confidential — this becomes the running footer printed at the bottom of every page.

Next, select the Header block on the canvas. In the Selected block panel, click Upload image and choose your transparent wordmark PNG. It appears as a slim masthead at the top of the page.

The Branding inspector panel with brand name, subtitle, and footer text fields.

Branding text feeds the header and the running page footer.

Step 4 — Style the header line

With the Header block still selected, scroll the Selected block panel:

  1. In Text, type a short, confident line: Brand Strategy Studio · Confidential.
  2. Set Text color to a muted warm grey-gold such as #A7A08B so it whispers rather than shouts.
  3. Set Alignment to Center so it sits centered beneath the wordmark.
  4. Add a little Margin bottom (around 28) to separate the masthead from the title.

The Selected block panel for the header, showing the new Text color swatches and a Center alignment control.

Per-block Text color and Alignment let header and footer text shine on a dark page.

Step 5 — Set premium typography

This is where a template stops looking like a document and starts looking like a brand. Open the Typography section and style each element using the Element dropdown. Aurelia uses two fonts only — restraint reads as premium.

Element Font Size Color Notes
Body EB Garamond 16 #CBC6B8 Line height 1.75 for an airy, editorial feel
Heading 1 DM Serif Display 40 #F3EEE2 The report title — warm near-white
Heading 2 DM Serif Display 25 #C9A44E Gold section heads
Heading 3 EB Garamond 13 #B6AD94 Uppercase, letter spacing 3 — a small-caps kicker
Blockquote EB Garamond 21 #E6D3A3 A gold-ruled pull quote
Table header EB Garamond 13 #F3EEE2 Uppercase, letter spacing 1.5

For each row: pick the element, choose the Font family, type the Font size, click the Color swatch, and set the extras (Letter spacing, Transform, Line height). The key to a dark template is Color — set light text colors here and the page comes alive.

The Typography inspector panel with element, font family, size, weight, color, and alignment controls.

Per-element typography. Pick an element, then style only that element.

Step 6 — Preview, test, and save

  1. Expand Exact PDF preview under the canvas to see a faithful render of the page.
  2. Test with real content. Paste a genuine document — headings, a table, a quote, lists — and confirm everything stays legible. Aurelia handles a positioning matrix and a roadmap without a wobble.
  3. Click Save template. It now appears in your Template library and is ready to use anywhere.

Page two of the finished report: a dark positioning-matrix table and a numbered roadmap, all legible on the dark page.

Real content — tables, lists, bold lead-ins — styled to stay crisp on the dark page.

Step 7 — Use your template in the converter

  1. Open the converter (the Convert link, or Open converter from the builder).
  2. Paste or write your Markdown.
  3. Under Saved templates, select Aurelia — Brand Strategy Report.
  4. Click Download Premium PDF.

That’s it — your Markdown comes out as a fully branded, watermark-free report.

Step 8 — Automate with the API

Once a template is saved, you can generate the same branded PDF programmatically — perfect for turning AI output, CMS content, or scheduled reports into client-ready documents.

1. Create an API key. Go to Dashboard → API keys and create one. It starts with mp_live_ and is shown only once, so copy it somewhere safe.

2. Find your template’s ID. While signed in, open https://markdowntopdfconverter.com/api/custom-templates in your browser. The JSON response lists every saved template with its id — copy the one you want.

3. Call the convert endpoint. Send your Markdown plus the customTemplateId:

curl -X POST https://markdowntopdfconverter.com/api/v1/convert \
  -H "Authorization: Bearer mp_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "## Northwind Outdoor — Brand Strategy\n\nYour report content in Markdown…",
    "templateId": "executive",
    "customTemplateId": "YOUR_TEMPLATE_ID",
    "filename": "northwind-brand-strategy",
    "options": { "pageNumbers": true }
  }' \
  --output northwind-brand-strategy.pdf

The same request in Node.js:

const res = await fetch("https://markdowntopdfconverter.com/api/v1/convert", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MP_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    markdown: "## Northwind Outdoor — Brand Strategy\n\nYour report content…",
    templateId: "executive",
    customTemplateId: "YOUR_TEMPLATE_ID",
    filename: "northwind-brand-strategy",
    options: { pageNumbers: true },
  }),
});

const pdf = Buffer.from(await res.arrayBuffer());

The response is the PDF file itself (Content-Type: application/pdf). Pass customTemplateId to apply your saved design; set templateId to its base template (here, executive). See the full API documentation for every option.

Design tips for premium results

  • Two fonts, maximum. Pair one display serif with one book serif (or a clean sans). Create hierarchy with size, weight, and color — not more fonts.
  • Let the page breathe. Generous line height and a quiet scrim do more for “premium” than any extra ornament.
  • Make contrast deliberate. On a dark page, reserve your brightest tone for the title, a gold for section heads, and a soft off-white for body text.
  • Transparent logos only. A wordmark on a transparent PNG sits cleanly on any background; a white-boxed logo will not.
  • Test before you ship. Always preview with real content — long headings, a wide table, a code block — so nothing surprises you later.

Next steps