Markdown to PDF Template: Start From a Skeleton
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.
このページの目次
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:
| Key | What it does |
|---|---|
title | Document title, also used for the PDF metadata |
toc / toc_depth | Real table of contents, and how many heading levels it lists |
number_sections | Automatic section numbers, so you never renumber by hand |
chapter_break | Each top-level heading starts a new page (thesis template) |
theme | Typography preset — newsprint in both templates |
pdf_ua | Ask 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
- Download the file and open it in any editor — it is plain Markdown, no plugin required.
- Replace the sample text, keep the front matter block, and put your own image next to the file (the template references
figure.png). - 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.pngbeside the.mdfile 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.
同じレンダラーをすぐに試せます。動作するサンプルを開いて書き出し、そのあと自分の Markdown を貼り付けてください。