typstgenv0.6.2

Warum Typst, und ein erster Brief

Einen Brief in zwanzig Zeilen Typst schreiben, mit typstgen übersetzen und sehen, wie ein Fehler gemeldet wird.

English version: Tutorial in English

Typst ist ein Satzsystem: Man schreibt Text mit wenigen Auszeichnungen in eine Datei, Typst setzt daraus ein PDF. Dieses Tutorial folgt einem roten Faden vom ersten Brief bis zur archivierten E-Rechnung, mit echten Befehlen und echten Ausgaben. Alle Befehle und Ausgaben auf diesen Seiten sind im Oktober 2026 mit typstgen 0.4 (Signieren: 0.5) und Typst 0.15.1 gelaufen.

Warum Typst

Gegenüber einer Textverarbeitung liegt alles in einer lesbaren Textdatei. Sie lässt sich versionieren, vergleichen und automatisch übersetzen: dieselbe Quelle ergibt dasselbe PDF. Gegenüber LaTeX ist die Syntax knapper, Fehlermeldungen nennen Datei, Zeile und Spalte, und Vorlagen sind Funktionen in einer richtigen Programmiersprache.

Überschriften beginnen mit =, Fettdruck steht zwischen Sternchen (*fett*), Funktionen beginnen mit #: #table(…), #image(…), #bibliography(…). Formeln stehen zwischen Dollarzeichen. Daten kommen per json(…), csv(…) oder yaml(…) direkt in das Dokument.

typstgen übersetzt .typ-Dateien mit eingebetteter Typst-Engine, als Kommandozeile, als Rust-Bibliothek, als WebAssembly und als MCP-Server für KI-Agenten. Ein installiertes typst braucht es nicht.

Installieren

cargo install typstgen, Rust ab 1.92. Danach läuft alles lokal, ohne Konto und ohne Online-Editor.

Ein Brief in zwanzig Zeilen

1. Quelltext. Seitenformat und Schrift setzen, dann normaler Text, eine Überschrift und eine Tabelle.

#set page(paper: "a4", margin: 2.5cm)
#set text(lang: "de", font: "Libertinus Serif", size: 11pt)

#align(right)[Musterstadt, #datetime.today().display("[day].[month].[year]")]

= Angebot für die Dokumentenstrecke

Sehr geehrte Frau Beispiel,

vielen Dank für Ihre Anfrage. Wir schlagen vor:

#table(
  columns: (1fr, auto),
  table.header([*Leistung*], [*Preis*]),
  [Vorlagen für Brief und Rechnung], [1.200 €],
  [PDF-Erzeugung in der CI], [600 €],
)

2. Übersetzen. typstgen schreibt das PDF neben die Quelle und gibt seinen Pfad aus.

$ typstgen compile brief.typ
brief.pdf

3. Ein Tippfehler. Aus table.header wird table.heder. typstgen bricht ab, nennt Datei, Zeile und Spalte und endet mit Exit-Code 1. Das brauchen später Skripte, CI und KI-Agenten.

$ typstgen compile brief-fehler.typ
error: typst compilation failed:
brief-fehler.typ:14:9: error: function `table` does not contain field `heder`

Das Ergebnis ist ein PDF mit Datum, Überschrift und Tabelle:

Erste Seite des Briefs: Ort und Datum rechts oben, Überschrift „Angebot für die Dokumentenstrecke“, Anrede und eine Tabelle mit zwei Leistungen und Preisen

Das Datum kommt aus datetime.today(). Wie man es für reproduzierbare Dateien festlegt, zeigt Archiving (englisch).

Weiter: Ablauf, Vorlagen und Ablage.

Edit this page on GitHub · Docs for v0.6.2