Vanlig Markdown har ingen syntax för formler, men nästan alla moderna Markdown-verktyg stöder LaTeX-matematik via ett tillägg. Du skriver formeln i TeX-notation mellan dollartecken, och en matematikrenderare som KaTeX eller MathJax gör om den till korrekt typsatt matematik.
Den här guiden går igenom syntaxen som fungerar i GitHub, GitLab, Obsidian, Jupyter och Markdown Preview Editor, och ger dig en referens över de kommandon du kommer att använda mest.
Formler i löptext och fristående formler
Det finns två sorters matematik i Markdown:
- Formler i löptext står mitt i en mening. Omslut dem med enkla dollartecken:
$E = mc^2$. - Fristående formler får en egen centrerad rad. Omslut dem med dubbla dollartecken, oftast på separata rader.
markdownDen berömda formeln $E = mc^2$ får plats mitt i en mening.
$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$
Renderad ser den fristående formeln ut så här:
Grundläggande syntax
| Vad | Du skriver | Kommentar |
|---|---|---|
| Upphöjt | x^2, e^{i\pi} |
Använd klammerparenteser för mer än ett tecken |
| Nedsänkt | a_1, x_{n+1} |
|
| Bråk | \frac{a}{b} |
\dfrac för ett större bråk i löptext |
| Kvadratrot | \sqrt{x}, \sqrt[3]{x} |
|
| Summa, produkt | \sum_{i=1}^{n} i, \prod_{k} k |
|
| Integral | \int_0^1 x\,dx |
\, lägger till ett smalt mellanrum |
| Gränsvärde | \lim_{x \to 0} \frac{\sin x}{x} |
|
| Grekiska bokstäver | \alpha, \beta, \pi, \Omega |
Stor begynnelsebokstav ger versal |
| Relationer | \le, \ge, \ne, \approx, \equiv |
|
| Operatorer | \times, \cdot, \pm, \div |
|
| Mängder | \in, \subset, \cup, \cap, \mathbb{R} |
|
| Pilar | \to, \Rightarrow, \leftrightarrow |
|
| Text i formler | \text{if } x > 0 |
Behåller normala mellanrum |
| Vektorer, accenter | \vec{v}, \hat{x}, \bar{y} |
Klammerparenteser grupperar: x^10 visas som x¹0, medan x^{10} visas som x¹⁰. När en formel ser fel ut är saknade klammerparenteser den vanligaste orsaken.
Parenteser som växer
Vanliga parenteser behåller sin storlek. Använd \left och \right för att få dem att omsluta högt innehåll:
latex\left( \frac{a}{b} \right)^2 \quad \text{vs} \quad (\frac{a}{b})^2
Matriser
Matriser skrivs med miljöer. pmatrix ger runda parenteser, bmatrix hakparenteser och vmatrix lodstreck (en determinant). Kolumner skiljs åt med &, rader med \\.
latex$$
A = \begin{pmatrix}
1 & 2 \\
3 & 4
\end{pmatrix}
$$
Ekvationer på flera rader och justerade ekvationer
För att linjera flera steg vid likhetstecknet använder du miljön aligned i en fristående formel och markerar justeringspunkten med &:
latex$$
\begin{aligned}
(a + b)^2 &= (a + b)(a + b) \\
&= a^2 + 2ab + b^2
\end{aligned}
$$
För styckvis definierade funktioner använder du cases:
latex$$
|x| = \begin{cases}
x & \text{if } x \ge 0 \\
-x & \text{if } x < 0
\end{cases}
$$
Dollartecken som inte är matematik
Priser i en text kan av misstag bli formler. De flesta renderare följer Pandoc-regeln: det inledande $ får inte följas av ett mellanslag, och det avslutande $ får inte föregås av ett mellanslag eller följas av en siffra. Därför förblir ”mellan $5 och $10” oftast vanlig text. Är du osäker kan du sätta ett omvänt snedstreck framför dollartecknet: \$5.
KaTeX eller MathJax
Båda renderar samma LaTeX-syntax; skillnaden handlar mest om hastighet och täckning.
- KaTeX är snabbt och renderar synkront, vilket är perfekt för förhandsvisning i realtid. Det stöder den stora majoriteten av kommandon som används i dokumentation, anteckningar och uppsatser.
- MathJax stöder fler LaTeX-paket och används av GitHub och många akademiska webbplatser, men är tyngre.
Markdown Preview Editor använder KaTeX och laddar det bara när ett dokument faktiskt innehåller en formel, så dokument utan matematik förblir lätta. En formel som är skriven för KaTeX visas nästan alltid korrekt på GitHub också.
Formler på GitHub
GitHub renderar matematik i Markdown-filer, ärenden (issues) och pull requests. Det stöder $…$ och $$…$$, plus två alternativ för knepiga fall: $`…`$ för formler i löptext som innehåller tecken som Markdown annars skulle tolka, och ett kodblock med språket math för fristående ekvationer.
Skriv formler snabbare
- Använd formelknappen i det avancerade verktygsfältet i Markdown Preview Editor för att infoga en formelmall och redigera den sedan med förhandsvisningen bredvid.
- Spara en fil med kodsnuttar för de formler du använder ofta – matriser, justerade block,
cases. - Kombinera formler med Mermaid-diagram för att förklara algoritmer: ett flödesschema för stegen och en formel för varje steg.
- När dokumentet är klart kan du exportera det till HTML eller PDF – formlerna följer med i den exporterade filen.
Ny på Markdown överlag? Börja med Markdown-fusklappen.
Vanliga frågor
Hur skriver jag en ekvation i Markdown?
Omslut LaTeX-formeln med enkla dollartecken för en formel i löptext ($a^2 + b^2 = c^2$) eller dubbla dollartecken för en centrerad fristående ekvation. Markdown-verktyget måste ha stöd för matematik – det har GitHub, GitLab, Obsidian, Jupyter och Markdown Preview Editor.
Varför visas min formel som vanlig text?
Vanliga orsaker: verktyget saknar stöd för matematik, det finns ett mellanslag direkt efter det inledande $ eller direkt före det avslutande $, eller ett Markdown-tecken som _ eller * i formeln har tolkats som formatering. Prova en fristående formel med $$ på separata rader.
Hur skriver jag en matris i Markdown?
Använd \begin{pmatrix} … \end{pmatrix} (eller bmatrix, vmatrix) inom $$. Skilj kolumner åt med & och rader med \\.
Stöder KaTeX alla LaTeX-kommandon?
KaTeX stöder de flesta matematikkommandon som används i praktiken, men inte alla LaTeX-paket. Kommandon för dokumentlayout (som \section eller \usepackage) gäller inte alls för matematik i Markdown.