Thesis guide

Your thesis PDF, submission-ready

Most thesis PDFs fail on the same six things — none of them is about writing. This page shows the checklist, a Markdown structure that passes it, and the export step that turns it into a tagged PDF.

Why the requirement appeared

Deposited theses are read by humans and by software. Institutions that must meet accessibility rules (public universities in many countries, and publishers who ingest manuscripts) started asking for tagged PDFs because a plain PDF is unusable with a screen reader: no headings, no figure descriptions, no reading order.

The six things that actually fail

  • Heading levels that skip: cover page as h1, then chapters as h3, never h2.
  • Figures without alternative text — especially charts the candidate drew themselves.
  • Equations exported as pictures, so the text layer has a gap where the formula should be.
  • Tables without header cells, which reads as one long string of numbers.
  • No bookmarks for chapters, so a 120-page thesis cannot be navigated.
  • Wrong or missing document language, which makes the reader mispronounce everything.

A Markdown skeleton that passes

Write the structure, not the decoration. One H1 for the title, H2 per chapter, H3 for sections, alt text on every figure, header rows in every table:

# My Thesis Title

## Chapter 1 Introduction

Text…

### 1.1 Motivation

![Accuracy by method](figures/accuracy.png)

| Method | Accuracy |
| --- | --- |
| Baseline | 0.81 |
| Ours | 0.93 |

Three steps before you submit

  1. Run the free check on your Markdown: it catches the source-level items above — heading skips and alt text — and marks which ones the exporter fixes automatically. The document language is set by the export locale; equations-as-images, table headers and bookmarks are checked on the exported PDF.
  2. Fix what is left in the editor — usually a missing alt text or a skipped heading level.
  3. Export with PDF/UA on. Open the file and confirm the title, language and bookmarks survived.

Short answers

My school only asks for PDF/A. Do I need tagging too?

PDF/A covers archiving, not accessibility. If the requirement is archival, PDF/A is enough; if it says accessible or tagged, you need PDF/UA.

My thesis started as a scanned PDF. Can this help?

Not directly — a scan has no text to tag. Import the original document or re-export from Markdown; a scan needs OCR plus manual tagging, which is a different job.

Does exporting as PDF/UA change my content?

No. It changes how the file is structured for readers (tags, language, bookmarks). Your Markdown is not modified.

Check my thesis Markdown See the thesis packOpen the editor

Free PDF/UA check. PDF/UA and PDF/A exports are part of Pro.