Le Markdown de base n’a pas de syntaxe pour les formules, mais presque tous les outils Markdown modernes prennent en charge les formules LaTeX grâce à une extension. Vous écrivez la formule en notation TeX entre des signes dollar, et un moteur de rendu mathématique comme KaTeX ou MathJax la transforme en mathématiques correctement composées.
Ce guide présente la syntaxe qui fonctionne sur GitHub, GitLab, Obsidian, Jupyter et Markdown Preview Editor, ainsi qu’un mémo des commandes que vous utiliserez le plus.
Formules en ligne et formules centrées
Il existe deux types de formules en Markdown :
- Les formules en ligne s’insèrent dans une phrase. Entourez-les de signes dollar simples :
$E = mc^2$. - Les formules centrées (display) occupent leur propre ligne, centrée. Entourez-les de doubles signes dollar, généralement sur des lignes séparées.
markdownLa célèbre formule $E = mc^2$ tient dans une phrase.
$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$
Une fois rendue, la formule centrée ressemble à ceci :
Syntaxe essentielle
| Quoi | Vous tapez | Remarques |
|---|---|---|
| Exposant | x^2, e^{i\pi} |
Accolades pour plus d’un caractère |
| Indice | a_1, x_{n+1} |
|
| Fraction | \frac{a}{b} |
\dfrac pour une fraction plus grande en ligne |
| Racine carrée | \sqrt{x}, \sqrt[3]{x} |
|
| Somme, produit | \sum_{i=1}^{n} i, \prod_{k} k |
|
| Intégrale | \int_0^1 x\,dx |
\, ajoute une espace fine |
| Limite | \lim_{x \to 0} \frac{\sin x}{x} |
|
| Lettres grecques | \alpha, \beta, \pi, \Omega |
Majuscule initiale pour la capitale |
| Relations | \le, \ge, \ne, \approx, \equiv |
|
| Opérateurs | \times, \cdot, \pm, \div |
|
| Ensembles | \in, \subset, \cup, \cap, \mathbb{R} |
|
| Flèches | \to, \Rightarrow, \leftrightarrow |
|
| Texte dans une formule | \text{if } x > 0 |
Conserve les espaces normales |
| Vecteurs, accents | \vec{v}, \hat{x}, \bar{y} |
Les accolades regroupent : x^10 s’affiche x¹0, alors que x^{10} s’affiche x¹⁰. Quand une formule semble fausse, des accolades manquantes en sont la cause la plus fréquente.
Des parenthèses qui s’agrandissent
Les parenthèses simples gardent leur taille. Utilisez \left et \right pour qu’elles englobent un contenu haut :
latex\left( \frac{a}{b} \right)^2 \quad \text{vs} \quad (\frac{a}{b})^2
Matrices
Les matrices utilisent des environnements. pmatrix ajoute des parenthèses, bmatrix des crochets et vmatrix des barres verticales (un déterminant). Les colonnes sont séparées par &, les lignes par \\.
latex$$
A = \begin{pmatrix}
1 & 2 \\
3 & 4
\end{pmatrix}
$$
Équations sur plusieurs lignes et alignées
Pour aligner plusieurs étapes sur le signe égal, utilisez l’environnement aligned dans une formule centrée et marquez le point d’alignement avec & :
latex$$
\begin{aligned}
(a + b)^2 &= (a + b)(a + b) \\
&= a^2 + 2ab + b^2
\end{aligned}
$$
Pour les fonctions définies par morceaux, utilisez cases :
latex$$
|x| = \begin{cases}
x & \text{if } x \ge 0 \\
-x & \text{if } x < 0
\end{cases}
$$
Les signes dollar qui ne sont pas des formules
Des prix dans un texte peuvent se transformer par accident en formules. La plupart des moteurs de rendu suivent la règle de Pandoc : le $ ouvrant ne doit pas être suivi d’une espace, et le $ fermant ne doit pas être précédé d’une espace ni suivi d’un chiffre. Ainsi, « entre $5 et $10 » reste généralement du texte simple. En cas de doute, échappez le signe dollar : \$5.
KaTeX ou MathJax
Les deux rendent la même syntaxe LaTeX ; la différence tient surtout à la vitesse et à la couverture.
- KaTeX est rapide et effectue un rendu synchrone, ce qui est idéal pour un aperçu en direct. Il prend en charge la grande majorité des commandes utilisées dans la documentation, les notes et les articles.
- MathJax prend en charge davantage de paquets LaTeX et est utilisé par GitHub et de nombreux sites universitaires, mais il est plus lourd.
Markdown Preview Editor utilise KaTeX et ne le charge que lorsqu’un document contient réellement une formule : les documents sans formules restent légers. Une formule écrite pour KaTeX s’affichera presque toujours aussi sur GitHub.
Les formules sur GitHub
GitHub affiche les formules dans les fichiers Markdown, les issues et les pull requests. Il prend en charge $…$ et $$…$$, ainsi que deux alternatives pour les cas délicats : $`…`$ pour une formule en ligne contenant des caractères que le Markdown interpréterait, et un bloc de code avec le langage math pour les formules centrées.
Écrire des formules plus vite
- Utilisez le bouton Formule mathématique de la barre Éditeur avancé de Markdown Preview Editor pour insérer un modèle de formule, puis modifiez-le avec l’aperçu côte à côte.
- Gardez un fichier de snippets avec les formules que vous utilisez souvent — matrices, blocs alignés, cases.
- Combinez formules et diagrammes Mermaid pour expliquer des algorithmes : un organigramme pour les étapes, une formule pour chaque étape.
- Une fois le document prêt, exportez-le en HTML ou en PDF : les formules sont conservées dans le fichier exporté.
Vous débutez en Markdown ? Commencez par l’aide-mémoire Markdown.
Questions fréquentes
Comment écrire une équation en Markdown ?
Entourez la formule LaTeX de signes dollar simples pour une formule en ligne ($a^2 + b^2 = c^2$) ou de doubles signes dollar pour une équation centrée. L’outil Markdown doit prendre en charge les formules — c’est le cas de GitHub, GitLab, Obsidian, Jupyter et Markdown Preview Editor.
Pourquoi ma formule s’affiche-t-elle en texte brut ?
Raisons fréquentes : l’outil ne gère pas les formules, il y a une espace juste après le $ ouvrant ou juste avant le $ fermant, ou un caractère Markdown comme _ ou * dans la formule a été interprété comme de la mise en forme. Essayez une formule centrée avec $$ sur des lignes séparées.
Comment écrire une matrice en Markdown ?
Utilisez \begin{pmatrix} … \end{pmatrix} (ou bmatrix, vmatrix) à l’intérieur de $$. Séparez les colonnes par & et les lignes par \\.
KaTeX prend-il en charge toutes les commandes LaTeX ?
KaTeX gère la plupart des commandes mathématiques utilisées en pratique, mais pas tous les paquets LaTeX. Les commandes de mise en page de document (comme \section ou \usepackage) ne s’appliquent pas du tout aux formules en Markdown.