Skip to content

Choose a template

Choose the template that matches the document’s structure. Satz controls the page furniture and common styles; your headings, paragraphs, lists, figures, and tables remain normal Typst content. Each link below opens the matching function in the API reference. Its exact signature and source link let you inspect the accepted inputs.

Article, report, or book?

Template Good starting point Default layout
article A paper or essay organized into sections Two columns, with an optional title, authors, affiliations, and abstract
report A report, protocol, or thesis organized into chapters or sections One column, numbered headings, optional contents
book (experimental) A book or thesis with book-style front and back matter A cover, two-sided pages, and explicit front and main matter

For most theses, start with report. Choose book if you want its cover, facing-page layout, and explicit book structure. The templates share ordinary Typst content such as figures, tables, and references; section and chapter are ways of organizing that content, not restrictions on what you can write.

Report headings stay on the current page by default. Set config: (headings: (h1-pagebreak: true)) to start each top-level heading on a new page. Articles default to two columns; set config: (page: (columns: 1)) for one column, or choose another column count. Article and book are part of the local 0.2.0 development version; book remains experimental.

Published templates

Document Entry points Good starting point
Report, assignment, or protocol report General documents with numbered headings and optional contents. Start with Write your first report.
Research journal journal-entry, journal-index Dated notes, decisions, observations, and next steps. Follow Keep a research journal.
DIN-style letter letter German or English template labels with a window-envelope address block. Start with Write a letter.
Invoice invoice / rechnung German invoice layout and item table.
Legal complaint complaint / klageschrift German civil complaint document structure. Start with Prepare a legal complaint document.
Guest performance contract guest-contract / gastspielvertrag Contract, offer, or title-only invoice mode for a performance. Follow Create a guest performance contract.
Cover page cover-page Generated title page (layout: "research" or "minimal") or a composable body/footer cover. Start with Add a cover page.

English names are the documented interface. The German template names rechnung, klageschrift, and gastspielvertrag, and their German fields, remain compatibility aliases. The letter and invoice layouts keep their existing output language; guest-contract and complaint output remains German. Read the API reference for exact signatures and the configuration reference for settings and defaults.

Development and experimental templates

These interfaces are in the 0.2.1 source and are not available from the published @preview/satz:0.2.0 package. Follow Development versions to compile them.

Document or component Entry points Status and notes
Research article article Two-column scholarly layout with title, author and affiliation block, and abstract. Try Write a research article.
Book book, book-contents, book-index Experimental structure with front matter, main matter, appendices, back matter, and a two-column index. Follow Typeset a thesis or book.
Teaching material exercise, worked-example, analysis-note, answer-grid Reusable components for instructional documents.
Research proposal research-proposal, proposal-budget, proposal-gantt Flexible proposal cover and planning helpers. See Proposal guide.
DFG proposal dfg-proposal, dfg-supplement, dfg-publications Candidate for DFG form 53.01 (09/26), with limited documented scope.
NWO Talent Programme nwo-proposal, nwo-profile Only source-checked 2026 combinations are represented; consult profile coverage before use.
Citations and publications proposal-citations, proposal-publications Proposal-specific bibliography helpers.
Layout helpers callout, satz-figure, scientific-table, placeholder Components used within documents rather than as full document templates.

Candidate support for a funding scheme is not a guarantee that the document meets every call requirement. Check the current funder instructions and the limitations in Proposal templates and coverage.

How to read the API and configuration reference

The API reference describes the public function signatures, required content, record shapes, accepted enums, and helper return values. The configuration reference describes each shared setting’s type, default, and effect, with links to individual fields. For learning the markup language itself, see the Typst writing tutorial.