Markdown Thesis Template: Chapter Breaks, Numbers, PDF/UA
A thesis skeleton has to decide four things before you write: where chapters break, how sections are numbered, how deep the contents go, and whether the export is tagged. This template decides them in front matter.
このページの目次
What a thesis skeleton has to decide
Most thesis templates fail the same way: they look right for the first three pages and wrong at page forty. The decisions that cause that are structural, and they all live in one place — the front matter block at the top of the file.
There are four of them: where a chapter starts a new page, whether sections are numbered automatically, how deep the table of contents goes, and whether the exported PDF carries accessibility tags. Everything else you can fix later in a paragraph; these four you would have to fix across the whole document.
The front matter, line by line
These are the keys in markdown-thesis-template.md. They are read by the exporter, not by a plugin you have to install.
| Key | Value in the template | What it changes |
|---|---|---|
title | your working title | PDF metadata and the first page of the export |
author | your name | Metadata, and the name a reader sees |
toc / toc_depth | true / 3 | Real contents page, three heading levels deep |
number_sections | true | Automatic 1, 1.1, 1.1.1 — no manual renumbering |
chapter_break | 1 | Every top-level heading starts a new page |
theme | newsprint | Typography preset; change it without touching the text |
pdf_ua | true | Ask for a tagged PDF/UA export from the first run |
What is already written
The skeleton follows the order most examiners expect, and each section carries a note about what belongs there:
- Abstract — one paragraph: question, method, result.
- Introduction with a one-sentence research question and a short contribution list.
- Background with an inline formula and a display formula, so you can see how both render.
- Method with a parameter table and a code block.
- Results with a figure that has real alt text.
- Discussion, Conclusion, and a plain reference list.
Two habits are baked in because they are the ones that hurt later: the figure ships with descriptive alt text, and the display formula keeps the same variable names as the sentence above it.
How to use it without breaking it
- Download the file and keep the front matter block at the top — it is what makes the numbering and page breaks work.
- Replace the sample text section by section. Put your own image next to the file and point the figure at it.
- Export from the studio. The first export already has chapter breaks, numbers, contents and tagging.
If you delete a heading level from the template, run the free check afterwards: skipped heading levels are the most common way a clean-looking thesis fails an accessibility review.
What it will not do
- It is not your university's layout. Margins, fonts, cover wording and the order of front matter differ per institution. The template gives you a structural starting point; the visible layout is the part you may still have to adjust.
- It does not embed images for you. Keep the image file beside the
.mdfile, or change the path. - References are a plain list. If your field expects a bibliography file, attach it in the editor instead of pasting entries.
- It cannot fix a PDF that already exists. Everything here starts from Markdown; a scanned or Word-exported thesis needs OCR and manual tagging, which is a different job.
- It is not a submission guarantee. Passing a checker means the machine-checkable problems are gone, not that your school's reviewer will accept the document.
Check before you submit
Paste the file into the free checker before you write, and again when the chapters are done. It reports missing alt text, skipped heading levels, links with no target and a missing document title — each one points at the line in your Markdown.
If your school asks for a tagged PDF, the checklist is on the thesis accessibility guide; if it asks for archival output, the PDF/A guide explains what changes and what does not.
Related
The report version of this skeleton is the Markdown to PDF template, and the thesis page has localized sample PDFs you can compare against your own output before submitting.
同じレンダラーをすぐに試せます。動作するサンプルを開いて書き出し、そのあと自分の Markdown を貼り付けてください。