Why a skeleton beats a blank page

Start from a blank file and the first ten pages feel fast. Then the document grows, and every decision you postponed becomes an afternoon: is the title page counted in the contents, do chapters start on a new page, is the heading numbering manual or automatic.

A template decides those once, in front matter, before you write a word of content. The sample text is there to be replaced — the structure underneath stays.

What the front matter controls

Both templates start with a small block between two --- lines. These are the keys that actually change the export:

KeyWhat it does
titleDocument title, also used for the PDF metadata
toc / toc_depthReal table of contents, and how many heading levels it lists
number_sectionsAutomatic section numbers, so you never renumber by hand
chapter_breakEach top-level heading starts a new page (thesis template)
themeTypography preset — newsprint in both templates
pdf_uaAsk for a tagged PDF/UA-1 export (thesis template)

The report template

markdown-report-template.md is a quarterly review: a summary, a key-figures table, a method section with a SQL block, a figure with real alt text, an open-risk section and a next-steps table. It is short on purpose — you replace the sentences, not the skeleton.

The thesis template

markdown-thesis-template.md goes further: abstract through references, chapter_break so chapters start fresh pages, number_sections for automatic numbering, inline and display formulas, and pdf_ua: true so the export is tagged from the first run.

Two habits are baked in because they are the ones that bite later: every figure ships with descriptive alt text, and the display formula uses consistent variable names — a reader who sees w_i in one place and \omega in another has to re-learn the notation. The thesis-specific walkthrough of that skeleton (front matter keys, chapter breaks, PDF/UA) is its own article.

How to use one

  1. Download the file and open it in any editor — it is plain Markdown, no plugin required.
  2. Replace the sample text, keep the front matter block, and put your own image next to the file (the template references figure.png).
  3. Export from the studio. The template settings are read from the front matter, so the first export already has the right page size, contents and numbering.

What these templates do not do

  • They are not your school's layout. Margins, fonts and title-page wording differ per institution. If your template is stricter, the PDF/UA path still works — the visible layout is what you may need to adjust.
  • They do not embed images for you. The figure is referenced by path; keep figure.png beside the .md file or change the path.
  • References are a plain list. If you keep a bibliography file, attach it in the editor instead of pasting entries by hand.
  • They cannot fix a PDF someone else made. Everything here starts from Markdown. A scanned thesis or a Word export needs OCR and manual tagging, which is a different job.

Check the template before you trust it

Both templates pass the free accessibility check with zero errors — that is the minimum bar, and you can verify it yourself: paste the file into the checker and read the result before you write anything.

The check looks at the source, not the PDF: images without alt text, heading levels that skip, links with no target, and a missing document title. Those four are the ones that fail a submission review, and they are all cheaper to fix in the file than in the exported PDF.

Where to go next

If you need the layout presets rather than a file, the feature overview lists the four document templates and five print themes. If the document is a thesis with chapter breaks and PDF/UA, the thesis page has localized samples you can compare against your own output before submitting.