Il Markdown di base non ha una sintassi per le formule, ma quasi tutti gli strumenti Markdown moderni supportano le formule LaTeX tramite un’estensione. Scrivi la formula in notazione TeX tra simboli del dollaro e un motore di rendering come KaTeX o MathJax la trasforma in matematica tipograficamente corretta.
Questa guida presenta la sintassi che funziona su GitHub, GitLab, Obsidian, Jupyter e Markdown Preview Editor e ti offre un riepilogo dei comandi che userai più spesso.
Formule in linea e in evidenza
In Markdown esistono due tipi di formule:
- Le formule in linea stanno all’interno di una frase. Racchiudile tra singoli simboli del dollaro:
$E = mc^2$. - Le formule in evidenza (display) occupano una riga propria, centrata. Racchiudile tra doppi simboli del dollaro, di solito su righe separate.
markdownLa celebre formula $E = mc^2$ sta all’interno di una frase.
$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$
Una volta visualizzata, la formula in evidenza appare così:
Sintassi essenziale
| Cosa | Scrivi | Note |
|---|---|---|
| Apice | x^2, e^{i\pi} |
Usa le graffe per più di un carattere |
| Pedice | a_1, x_{n+1} |
|
| Frazione | \frac{a}{b} |
\dfrac per una frazione più grande in linea |
| Radice quadrata | \sqrt{x}, \sqrt[3]{x} |
|
| Sommatoria, produttoria | \sum_{i=1}^{n} i, \prod_{k} k |
|
| Integrale | \int_0^1 x\,dx |
\, aggiunge uno spazio sottile |
| Limite | \lim_{x \to 0} \frac{\sin x}{x} |
|
| Lettere greche | \alpha, \beta, \pi, \Omega |
Iniziale maiuscola per le maiuscole |
| Relazioni | \le, \ge, \ne, \approx, \equiv |
|
| Operatori | \times, \cdot, \pm, \div |
|
| Insiemi | \in, \subset, \cup, \cap, \mathbb{R} |
|
| Frecce | \to, \Rightarrow, \leftrightarrow |
|
| Testo nella formula | \text{if } x > 0 |
Mantiene la spaziatura normale |
| Vettori, accenti | \vec{v}, \hat{x}, \bar{y} |
Le graffe raggruppano: x^10 viene visualizzato come x¹0, mentre x^{10} come x¹⁰. Quando una formula ha un aspetto sbagliato, le graffe mancanti sono la causa più comune.
Parentesi che si adattano
Le parentesi normali mantengono la loro dimensione. Usa \left e \right per farle crescere attorno a contenuti alti:
latex\left( \frac{a}{b} \right)^2 \quad \text{vs} \quad (\frac{a}{b})^2
Matrici
Le matrici usano gli ambienti. pmatrix aggiunge parentesi tonde, bmatrix parentesi quadre e vmatrix barre verticali (un determinante). Le colonne si separano con &, le righe con \\.
latex$$
A = \begin{pmatrix}
1 & 2 \\
3 & 4
\end{pmatrix}
$$
Equazioni su più righe e allineate
Per allineare più passaggi sul segno di uguale, usa l’ambiente aligned all’interno di una formula in evidenza e indica il punto di allineamento con &:
latex$$
\begin{aligned}
(a + b)^2 &= (a + b)(a + b) \\
&= a^2 + 2ab + b^2
\end{aligned}
$$
Per le funzioni definite a tratti, usa cases:
latex$$
|x| = \begin{cases}
x & \text{if } x \ge 0 \\
-x & \text{if } x < 0
\end{cases}
$$
Simboli del dollaro che non sono formule
I prezzi in un testo possono trasformarsi per sbaglio in formule. La maggior parte dei renderer segue la regola di Pandoc: il $ di apertura non deve essere seguito da uno spazio e il $ di chiusura non deve essere preceduto da uno spazio né seguito da una cifra. Così «tra $5 e $10» di solito resta testo normale. Nel dubbio, fai l’escape del simbolo del dollaro: \$5.
KaTeX o MathJax
Entrambi visualizzano la stessa sintassi LaTeX; la differenza sta soprattutto in velocità e copertura.
- KaTeX è veloce ed esegue il rendering in modo sincrono, ideale per l’anteprima in tempo reale. Supporta la grande maggioranza dei comandi usati in documentazione, appunti e articoli.
- MathJax supporta un insieme più ampio di pacchetti LaTeX ed è usato da GitHub e da molti siti accademici, ma è più pesante.
Markdown Preview Editor usa KaTeX e lo carica solo quando un documento contiene davvero una formula, così i documenti senza matematica restano leggeri. Una formula scritta per KaTeX verrà quasi sempre visualizzata correttamente anche su GitHub.
Le formule su GitHub
GitHub visualizza le formule nei file Markdown, nelle issue e nelle pull request. Supporta $…$ e $$…$$, più due alternative per i casi difficili: $`…`$ per formule in linea che contengono caratteri che Markdown interpreterebbe, e un blocco di codice con il linguaggio math per le equazioni in evidenza.
Scrivere formule più velocemente
- Usa il pulsante formula nella barra Editor avanzato di Markdown Preview Editor per inserire un modello di formula, poi modificalo con l’anteprima affiancata.
- Tieni un file di snippet con le formule che usi spesso: matrici, blocchi allineati, casi.
- Combina le formule con i diagrammi Mermaid per spiegare gli algoritmi: un diagramma di flusso per i passaggi e una formula per ciascun passaggio.
- Quando il documento è pronto, esportalo in HTML o PDF: le formule vengono mantenute nel file esportato.
Sei alle prime armi con Markdown? Parti dal cheat sheet Markdown.
Domande frequenti
Come si scrive un’equazione in Markdown?
Racchiudi la formula LaTeX tra singoli simboli del dollaro per le formule in linea ($a^2 + b^2 = c^2$) o tra doppi simboli del dollaro per un’equazione centrata in evidenza. Lo strumento Markdown deve supportare le formule: GitHub, GitLab, Obsidian, Jupyter e Markdown Preview Editor lo fanno.
Perché la mia formula appare come testo normale?
Cause comuni: lo strumento non supporta le formule, c’è uno spazio subito dopo il $ di apertura o subito prima del $ di chiusura, oppure un carattere Markdown come _ o * all’interno della formula è stato interpretato come formattazione. Prova una formula in evidenza con $$ su righe separate.
Come si scrive una matrice in Markdown?
Usa \begin{pmatrix} … \end{pmatrix} (oppure bmatrix, vmatrix) all’interno di $$. Separa le colonne con & e le righe con \\.
KaTeX supporta tutti i comandi LaTeX?
KaTeX supporta la maggior parte dei comandi matematici usati nella pratica, ma non tutti i pacchetti LaTeX. I comandi per l’impaginazione del documento (come \section o \usepackage) non si applicano affatto alle formule in Markdown.