Il Markdown standard non prevede la matematica. Non c’è nella specifica originale e non c’è nel CommonMark: è un’estensione, come le tabelle, e la sintassi che si è imposta ovunque è quella del LaTeX, il sistema di composizione usato dalla comunità scientifica da quarant’anni.
Funziona così: racchiudi la formula fra simboli di dollaro e il compositore la trasforma in matematica vera, con le frazioni impilate, gli indici al posto giusto e i simboli greci.
In linea o a blocco
Ci sono due modi, e la differenza è dove finisce la formula.
In linea, dentro il testo, fra dollari singoli:
L'equazione $E = mc^2$ ha cambiato la fisica.L’equazione ha cambiato la fisica.
A blocco, isolata e centrata su una riga sua, fra dollari doppi:
$$
\int_{a}^{b} f(x)\,dx = F(b) - F(a)
$$La regola pratica: se la formula ha un’altezza — una frazione, un integrale, una sommatoria — mettila a blocco, perché in linea schiaccerebbe l’interlinea del paragrafo.
La sintassi LaTeX che serve davvero
Il LaTeX è enorme, ma per scrivere il novanta per cento delle formule bastano una dozzina di comandi.
| Cosa | Come si scrive | Risultato |
|---|---|---|
| Esponente | x^2 | x elevato a 2 |
| Indice | x_1 | x con pedice 1 |
| Frazione | \frac{a}{b} | a fratto b |
| Radice | \sqrt{x}, \sqrt[3]{x} | radice quadrata, cubica |
| Sommatoria | \sum_{i=1}^{n} | sommatoria da 1 a n |
| Integrale | \int_{a}^{b} | integrale da a a b |
| Lettere greche | \alpha \beta \pi \Omega | α β π Ω |
| Moltiplicazione | \times, \cdot | × · |
| Confronti | \leq \geq \neq \approx | ≤ ≥ ≠ ≈ |
| Infinito | \infty | ∞ |
| Limite | \lim_{x \to 0} | limite per x che tende a 0 |
| Vettore | \vec{v} | v con la freccia |
Due cose da ricordare più di tutte:
- Le graffe raggruppano.
x^2nmette all’esponente solo il 2;x^{2n}ci mette tutto. Nel dubbio, metti le graffe. - La spaziatura la decide il compositore. Gli spazi che scrivi vengono ignorati:
\,\;\quadsono i comandi per aggiungerne davvero.
Qualche formula per intero
La formula risolutiva dell’equazione di secondo grado:
$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$Una matrice:
$$
\begin{bmatrix}
a & b \\
c & d
\end{bmatrix}
$$Una funzione definita a tratti:
$$
f(x) = \begin{cases}
x^2 & \text{se } x \geq 0 \\
-x & \text{se } x < 0
\end{cases}
$$Nota \text{}: dentro una formula, tutto il testo normale va lì dentro, altrimenti il LaTeX lo compone come una sequenza di variabili in corsivo.
Perché KaTeX
Quasi tutti gli editor moderni compongono la matematica con KaTeX, una libreria nata in Khan Academy, invece del più vecchio MathJax. La ragione è la velocità: KaTeX compone in modo sincrono e praticamente istantaneo, il che è quello che serve a un’anteprima live che si aggiorna a ogni tasto premuto. MathJax copre qualche comando esotico in più, ma è sensibilmente più lento.
In pratica, se non stai scrivendo notazione molto specialistica, non noterai mai la differenza in copertura, mentre noterai eccome quella in reattività.
Scrivere formule in Inkiostro
In Inkiostro la matematica è nel piano gratuito, su Mac, iPad e iPhone. Scrivi $...$ o $$...$$ e la formula si compone nell’anteprima mentre digiti, senza attivare niente.
La parte che conta è però l’esportazione. Nel PDF le formule restano testo selezionabile, non immagini appiattite: puoi copiarle, cercarle e ingrandirle senza vederle sgranare. È una differenza che si nota subito quando qualcuno prova a cercare una variabile dentro il PDF di una tesi, e vale anche per i blocchi di codice evidenziato e per i diagrammi.
Lo stesso vale per l’export in HTML e in EPUB: la matematica sopravvive al passaggio.
Consigli
- Formule a blocco per tutto ciò che ha altezza. Frazioni, integrali e sommatorie in linea rovinano l’interlinea del paragrafo.
- Graffe generose. Costano un carattere e prevengono l’errore più comune.
\text{}per le parole dentro una formula.- Controlla la destinazione. GitHub compone il LaTeX nei file
.md, ma non tutte le piattaforme lo fanno: se il documento deve finire su un servizio di terze parti, verifica prima di scrivere trecento formule. - Se una formula non si compone, quasi sempre è una graffa non chiusa o un comando scritto male. I compositori segnalano l’errore in rosso proprio nel punto.
Domande frequenti
Il Markdown standard supporta le formule matematiche?
No. Né la specifica originale del 2004 né il CommonMark prevedono la matematica: è un’estensione, esattamente come le tabelle. La sintassi che si è affermata è quella del LaTeX fra simboli di dollaro, ed è supportata da GitHub, da quasi tutti gli editor moderni e dai generatori di siti statici, ma non è garantita ovunque.
Come scrivo un’equazione in linea in Markdown?
Racchiudendola fra due simboli di dollaro singoli: $E = mc^2$ dentro una frase. Per una formula isolata e centrata su una riga sua si usano invece i dollari doppi, $$ ... $$. La regola pratica è mettere a blocco tutto ciò che ha un’altezza, come frazioni e integrali, perché in linea deformerebbe l’interlinea.
Cos’è KaTeX?
È la libreria che compone la notazione LaTeX in matematica visibile, nata in Khan Academy. Rispetto al più vecchio MathJax è molto più veloce perché lavora in modo sincrono, ed è per questo che gli editor con anteprima live la preferiscono: la formula si ricompone a ogni tasto senza ritardi percepibili.
Posso esportare in PDF le formule scritte in Markdown?
Sì, ma il risultato dipende dall’editor. Alcuni appiattiscono la matematica in immagini, e nel PDF le formule non si possono più selezionare né cercare, e sgranano se ingrandite. Inkiostro le mantiene come testo selezionabile, insieme ai diagrammi e al codice evidenziato — cosa che conta parecchio in una tesi o in un documento tecnico.
Devo conoscere tutto il LaTeX per scrivere formule in Markdown?
No. Con una dozzina di comandi — esponenti, indici, frazioni, radici, sommatorie, integrali e lettere greche — copri la grande maggioranza di quello che si scrive normalmente. Il resto si cerca quando serve: nessuno tiene a mente l’intero LaTeX, nemmeno chi lo usa da anni.