Reines Markdown hat keine Syntax für Formeln, doch fast jedes moderne Markdown-Werkzeug unterstützt LaTeX-Mathematik über eine Erweiterung. Sie schreiben die Formel in TeX-Notation zwischen Dollarzeichen, und ein Formel-Renderer wie KaTeX oder MathJax setzt sie als saubere Mathematik.
Diese Anleitung zeigt die Syntax, die in GitHub, GitLab, Obsidian, Jupyter und dem Markdown Preview Editor funktioniert, und liefert eine Übersicht der Befehle, die Sie am häufigsten brauchen.
Formeln im Text und abgesetzte Formeln
In Markdown gibt es zwei Arten von Formeln:
- Inline-Formeln stehen mitten im Satz. Umschließen Sie sie mit einfachen Dollarzeichen:
$E = mc^2$. - Abgesetzte Formeln bekommen eine eigene, zentrierte Zeile. Umschließen Sie sie mit doppelten Dollarzeichen, meist in eigenen Zeilen.
markdownDie berühmte Formel $E = mc^2$ passt in einen Satz.
$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$
Dargestellt sieht die abgesetzte Formel so aus:
Die wichtigste Syntax
| Was | Sie tippen | Hinweise |
|---|---|---|
| Hochgestellt | x^2, e^{i\pi} |
Geschweifte Klammern für mehr als ein Zeichen |
| Tiefgestellt | a_1, x_{n+1} |
|
| Bruch | \frac{a}{b} |
\dfrac für einen größeren Bruch im Text |
| Quadratwurzel | \sqrt{x}, \sqrt[3]{x} |
|
| Summe, Produkt | \sum_{i=1}^{n} i, \prod_{k} k |
|
| Integral | \int_0^1 x\,dx |
\, fügt einen schmalen Abstand ein |
| Grenzwert | \lim_{x \to 0} \frac{\sin x}{x} |
|
| Griechische Buchstaben | \alpha, \beta, \pi, \Omega |
Großer Anfangsbuchstabe für Großbuchstaben |
| Relationen | \le, \ge, \ne, \approx, \equiv |
|
| Operatoren | \times, \cdot, \pm, \div |
|
| Mengen | \in, \subset, \cup, \cap, \mathbb{R} |
|
| Pfeile | \to, \Rightarrow, \leftrightarrow |
|
| Text in Formeln | \text{if } x > 0 |
Behält normale Abstände bei |
| Vektoren, Akzente | \vec{v}, \hat{x}, \bar{y} |
Geschweifte Klammern gruppieren: x^10 wird als x¹0 dargestellt, x^{10} dagegen als x¹⁰. Sieht eine Formel falsch aus, sind fehlende Klammern der häufigste Grund.
Mitwachsende Klammern
Normale Klammern behalten ihre Größe. Mit \left und \right passen sie sich an hohen Inhalt an:
latex\left( \frac{a}{b} \right)^2 \quad \text{vs} \quad (\frac{a}{b})^2
Matrizen
Matrizen verwenden Umgebungen. pmatrix setzt runde Klammern, bmatrix eckige Klammern und vmatrix senkrechte Striche (eine Determinante). Spalten werden mit & getrennt, Zeilen mit \\.
latex$$
A = \begin{pmatrix}
1 & 2 \\
3 & 4
\end{pmatrix}
$$
Mehrzeilige und ausgerichtete Gleichungen
Um mehrere Umformungsschritte am Gleichheitszeichen auszurichten, verwenden Sie die Umgebung aligned in einer abgesetzten Formel und markieren den Ausrichtungspunkt mit &:
latex$$
\begin{aligned}
(a + b)^2 &= (a + b)(a + b) \\
&= a^2 + 2ab + b^2
\end{aligned}
$$
Für abschnittsweise definierte Funktionen verwenden Sie cases:
latex$$
|x| = \begin{cases}
x & \text{if } x \ge 0 \\
-x & \text{if } x < 0
\end{cases}
$$
Dollarzeichen, die keine Formeln sind
Preise im Text können versehentlich zu Formeln werden. Die meisten Renderer folgen der Pandoc-Regel: Auf das öffnende $ darf kein Leerzeichen folgen, und vor dem schließenden $ darf kein Leerzeichen stehen, dahinter keine Ziffer. „Zwischen $5 und $10“ bleibt daher meist normaler Text. Im Zweifel maskieren Sie das Dollarzeichen: \$5.
KaTeX oder MathJax
Beide stellen dieselbe LaTeX-Syntax dar; der Unterschied liegt vor allem in Geschwindigkeit und Umfang.
- KaTeX ist schnell und rendert synchron – ideal für eine Live-Vorschau. Es unterstützt die allermeisten Befehle, die in Dokumentation, Notizen und wissenschaftlichen Arbeiten vorkommen.
- MathJax unterstützt mehr LaTeX-Pakete und wird von GitHub und vielen akademischen Websites verwendet, ist aber schwergewichtiger.
Der Markdown Preview Editor verwendet KaTeX und lädt es nur, wenn ein Dokument tatsächlich eine Formel enthält – Dokumente ohne Formeln bleiben also schlank. Eine für KaTeX geschriebene Formel wird fast immer auch auf GitHub korrekt dargestellt.
Formeln auf GitHub
GitHub stellt Formeln in Markdown-Dateien, Issues und Pull Requests dar. Unterstützt werden $…$ und $$…$$ sowie zwei Alternativen für knifflige Fälle: $`…`$ für Inline-Formeln mit Zeichen, die Markdown sonst interpretieren würde, und ein Codeblock mit der Sprache math für abgesetzte Gleichungen.
Formeln schneller schreiben
- Nutzen Sie die Schaltfläche Mathematische Formel im Erweiterten Editor des Markdown Preview Editor, um eine Formelvorlage einzufügen, und bearbeiten Sie sie dann mit der Vorschau daneben.
- Legen Sie eine Snippet-Datei mit häufig genutzten Formeln an – Matrizen, ausgerichtete Blöcke, Fallunterscheidungen.
- Kombinieren Sie Formeln mit Mermaid-Diagrammen, um Algorithmen zu erklären: ein Flussdiagramm für die Schritte und eine Formel für jeden Schritt.
- Ist das Dokument fertig, exportieren Sie es als HTML oder PDF – die Formeln bleiben in der exportierten Datei erhalten.
Neu bei Markdown? Beginnen Sie mit dem Markdown-Spickzettel.
Häufig gestellte Fragen
Wie schreibe ich eine Gleichung in Markdown?
Umschließen Sie die LaTeX-Formel mit einfachen Dollarzeichen für eine Inline-Formel ($a^2 + b^2 = c^2$) oder mit doppelten Dollarzeichen für eine zentrierte, abgesetzte Gleichung. Das Markdown-Werkzeug muss Formeln unterstützen – GitHub, GitLab, Obsidian, Jupyter und der Markdown Preview Editor tun das.
Warum wird meine Formel als normaler Text angezeigt?
Häufige Gründe: Das Werkzeug unterstützt keine Formeln, direkt nach dem öffnenden $ oder direkt vor dem schließenden $ steht ein Leerzeichen, oder ein Markdown-Zeichen wie _ oder * in der Formel wurde als Formatierung interpretiert. Versuchen Sie eine abgesetzte Formel mit $$ in eigenen Zeilen.
Wie schreibe ich eine Matrix in Markdown?
Verwenden Sie \begin{pmatrix} … \end{pmatrix} (oder bmatrix, vmatrix) innerhalb von $$. Trennen Sie Spalten mit & und Zeilen mit \\.
Unterstützt KaTeX alle LaTeX-Befehle?
KaTeX unterstützt die meisten in der Praxis genutzten Mathematikbefehle, aber nicht jedes LaTeX-Paket. Befehle für das Dokumentlayout (wie \section oder \usepackage) spielen für Formeln in Markdown ohnehin keine Rolle.