Gewone Markdown heeft geen syntaxis voor formules, maar bijna elke moderne Markdown-tool ondersteunt LaTeX-formules via een uitbreiding. Je schrijft de formule in TeX-notatie tussen dollartekens, en een renderer zoals KaTeX of MathJax zet die om in netjes gezette wiskunde.
Deze handleiding behandelt de syntaxis die werkt in GitHub, GitLab, Obsidian, Jupyter en Markdown Preview Editor, en geeft je een overzicht van de opdrachten die je het vaakst gebruikt.
Inline formules en losse vergelijkingen
Er zijn twee soorten formules in Markdown:
- Inline formules staan midden in een zin. Zet ze tussen enkele dollartekens:
$E = mc^2$. - Losse vergelijkingen (display math) krijgen een eigen, gecentreerde regel. Zet ze tussen dubbele dollartekens, meestal op aparte regels.
markdownDe beroemde formule $E = mc^2$ past midden in een zin.
$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$
Weergegeven ziet de losse vergelijking er zo uit:
De belangrijkste syntaxis
| Wat | Je typt | Opmerkingen |
|---|---|---|
| Superscript | x^2, e^{i\pi} |
Gebruik accolades bij meer dan één teken |
| Subscript | a_1, x_{n+1} |
|
| Breuk | \frac{a}{b} |
\dfrac voor een grotere breuk in de tekst |
| Wortel | \sqrt{x}, \sqrt[3]{x} |
|
| Som, product | \sum_{i=1}^{n} i, \prod_{k} k |
|
| Integraal | \int_0^1 x\,dx |
\, voegt een smalle spatie toe |
| Limiet | \lim_{x \to 0} \frac{\sin x}{x} |
|
| Griekse letters | \alpha, \beta, \pi, \Omega |
Hoofdletter voor de hoofdletterversie |
| Relaties | \le, \ge, \ne, \approx, \equiv |
|
| Operatoren | \times, \cdot, \pm, \div |
|
| Verzamelingen | \in, \subset, \cup, \cap, \mathbb{R} |
|
| Pijlen | \to, \Rightarrow, \leftrightarrow |
|
| Tekst in een formule | \text{if } x > 0 |
Behoudt de normale spatiëring |
| Vectoren, accenten | \vec{v}, \hat{x}, \bar{y} |
Accolades groeperen: x^10 wordt weergegeven als x¹0, terwijl x^{10} x¹⁰ oplevert. Ziet een formule er vreemd uit, dan zijn ontbrekende accolades de meest voorkomende oorzaak.
Haakjes die meegroeien
Gewone haakjes behouden hun grootte. Gebruik \left en \right om ze om hoge inhoud heen te laten groeien:
latex\left( \frac{a}{b} \right)^2 \quad \text{vs} \quad (\frac{a}{b})^2
Matrices
Matrices gebruiken omgevingen. pmatrix voegt ronde haken toe, bmatrix vierkante haken en vmatrix verticale strepen (een determinant). Kolommen worden gescheiden door &, rijen door \\.
latex$$
A = \begin{pmatrix}
1 & 2 \\
3 & 4
\end{pmatrix}
$$
Vergelijkingen over meerdere regels, uitgelijnd
Wil je meerdere stappen uitlijnen op het isgelijkteken, gebruik dan de omgeving aligned binnen een losse vergelijking en markeer het uitlijnpunt met &:
latex$$
\begin{aligned}
(a + b)^2 &= (a + b)(a + b) \\
&= a^2 + 2ab + b^2
\end{aligned}
$$
Voor functies met meerdere voorschriften gebruik je cases:
latex$$
|x| = \begin{cases}
x & \text{if } x \ge 0 \\
-x & \text{if } x < 0
\end{cases}
$$
Dollartekens die geen formule zijn
Prijzen in een tekst kunnen per ongeluk formules worden. De meeste renderers volgen de Pandoc-regel: na de openende $ mag geen spatie staan, en vóór de sluitende $ mag geen spatie staan en erna geen cijfer. Daardoor blijft “tussen $5 en $10” meestal gewone tekst. Twijfel je, escape het dollarteken dan: \$5.
KaTeX of MathJax
Beide geven dezelfde LaTeX-syntaxis weer; het verschil zit vooral in snelheid en dekking.
- KaTeX is snel en rendert synchroon, wat ideaal is voor een live voorbeeld. Het ondersteunt het overgrote deel van de opdrachten die in documentatie, notities en papers worden gebruikt.
- MathJax ondersteunt meer LaTeX-pakketten en wordt gebruikt door GitHub en veel wetenschappelijke websites, maar is zwaarder.
Markdown Preview Editor gebruikt KaTeX en laadt het alleen als een document echt een formule bevat, zodat documenten zonder wiskunde licht blijven. Een formule die voor KaTeX is geschreven, wordt vrijwel altijd ook op GitHub goed weergegeven.
Formules op GitHub
GitHub geeft formules weer in Markdown-bestanden, issues en pull requests. Het ondersteunt $…$ en $$…$$, plus twee alternatieven voor lastige gevallen: $`…`$ voor inline formules met tekens die Markdown anders zou interpreteren, en een codeblok met de taal math voor losse vergelijkingen.
Sneller formules schrijven
- Gebruik de formuleknop in de werkbalk van de geavanceerde editor van Markdown Preview Editor om een formulesjabloon in te voegen, en bewerk het met het voorbeeld ernaast.
- Houd een bestand bij met de formules die je vaak gebruikt — matrices, uitgelijnde blokken, cases.
- Combineer formules met Mermaid-diagrammen om algoritmen uit te leggen: een stroomdiagram voor de stappen en een formule per stap.
- Is het document klaar, exporteer het dan naar HTML of pdf — de formules blijven in het geëxporteerde bestand behouden.
Nieuw met Markdown? Begin met de Markdown cheat sheet.
Veelgestelde vragen
Hoe schrijf ik een vergelijking in Markdown?
Zet de LaTeX-formule tussen enkele dollartekens voor een inline formule ($a^2 + b^2 = c^2$) of tussen dubbele dollartekens voor een gecentreerde losse vergelijking. De Markdown-tool moet formules ondersteunen — GitHub, GitLab, Obsidian, Jupyter en Markdown Preview Editor doen dat.
Waarom wordt mijn formule als gewone tekst getoond?
Veelvoorkomende oorzaken: de tool ondersteunt geen formules, er staat een spatie direct na de openende $ of direct vóór de sluitende $, of een Markdown-teken zoals _ of * in de formule is als opmaak geïnterpreteerd. Probeer een losse vergelijking met $$ op aparte regels.
Hoe schrijf ik een matrix in Markdown?
Gebruik \begin{pmatrix} … \end{pmatrix} (of bmatrix, vmatrix) binnen $$. Scheid kolommen met & en rijen met \\.
Ondersteunt KaTeX alle LaTeX-opdrachten?
KaTeX ondersteunt de meeste wiskundige opdrachten die in de praktijk worden gebruikt, maar niet elk LaTeX-pakket. Opdrachten voor de documentopmaak (zoals \section of \usepackage) zijn helemaal niet van toepassing op formules in Markdown.