# Typst zu HTML

Typst-Markup in eigenständiges HTML mit MathML-Formeln umwandeln, ohne ein Projekt anzulegen.

Typst zu HTML macht aus eingefügtem Typst eine HTML-Datei, die sich in jedem Browser öffnen lässt. Formeln werden als MathML geschrieben, sodass Leser sie markieren können und Hilfstechnologien sie vorlesen können.

## Wofür Sie es nutzen

- eine Webfassung eines kurzen Typst-Dokuments oder einer Sammlung von Notizen;
- Inhalt, der auf Telefonen und schmalen Bildschirmen umbrechen muss;
- eine schnelle HTML-Version eines Abschnitts, an dem Sie gerade arbeiten.

Es übernimmt nicht das Seitendesign des PDFs. Exportieren Sie das PDF, wenn es auf ein exaktes Layout ankommt.

## Den Quelltext umwandeln

1. Öffnen Sie **Typst zu HTML**, oder führen Sie `/typst-to-html` aus.
2. Fügen Sie ein Typst-Fragment oder ein vollständiges Dokument ein, oder wählen Sie **Beispiel laden**.
3. Wählen Sie **Umwandeln**.
4. Kopieren Sie das HTML oder speichern Sie `converted.html`, und öffnen Sie es dann in einem Browser.
5. Prüfen Sie Überschriften, Links, Formeln, Tabellen und Abbildungen.

Zum Beispiel:

```typst
= Result
For $x > 0$, the loss decreases.
```

wird zu einer HTML-Überschrift und einem Absatz, mit der Inline-Formel als MathML.

## Was die Ausgabe enthält

Der mitgelieferte Pandoc liest das Typst und schreibt auf Ihrem Gerät ein eigenständiges HTML-Dokument, mit MathML-Formeln und den Ressourcen, die sich einbetten lassen.

Pandoc liest Typst-Markup, nicht die Skriptsprache von Typst. `#let`-Funktionen, `show`-Regeln, Pakete und berechnete Inhalte können entfallen oder vereinfacht werden. Für ein ganzes Typst-Projekt nutzen Sie stattdessen **Exportieren** in der Projekt-Werkzeugleiste: Es baut HTML aus Typsts eigener Ausgabe und bewahrt damit mehr Ihrer Formeln und Verweise. [Ein Projekt exportieren und konvertieren](/docs/export/) erklärt die Möglichkeiten.

:::caution[Barrierefreies HTML braucht weiterhin Prüfung]
MathML und echte Überschriften sind ein guter Anfang, kein Zertifikat. Testen Sie die Reihenfolge der Tastaturnavigation, den Linktext, Bildbeschreibungen, Tabellenkopfzeilen und den Farbkontrast, bevor Sie die Seite barrierefrei nennen.
:::

Für einen LaTeX-Quelltext nutzen Sie [LaTeX zu HTML](/docs/tools/latex-to-html/).
