Formules mathématiques dans Markdown : avec $, $$, \( \) et \[ \]

Les notes, les devoirs, les comptes rendus de TP et les réponses d’IA contiennent souvent des formules. Dans un fichier Markdown, elles s’écrivent en LaTeX, comme $E = mc^2$. Une visionneuse de texte brut l’affiche comme du code brut. Un lecteur qui compose les formules mathématiques affiche la vraie formule.

Ce guide montre comment écrire des formules mathématiques en Markdown, quels délimiteurs utiliser et ce qui peut mal tourner.

Formules en ligne et formules affichées

Il y a deux sortes de formules :

The famous formula is $E = mc^2$ and it stays in the sentence.

$$\int_0^1 x\,dx = \tfrac{1}{2}$$

Les quatre délimiteurs

Les délimiteurs sont les marques autour de la formule. Tu en rencontreras quatre :

DélimiteursTypeExemple
$…$en ligne$a^2 + b^2 = c^2$
$$…$$affichée$$a^2 + b^2 = c^2$$
\(…\)en ligne\(a^2 + b^2 = c^2\)
\[…\]affichée\[a^2 + b^2 = c^2\]

Ce sont des conventions. Les formules mathématiques ne font pas partie de la spécification CommonMark ni de GitHub Flavored Markdown, donc chaque outil décide de ce qu’il lit.

```math
\sum_{k=1}^n k = \frac{n(n+1)}{2}
```

Si tu as un doute, utilise $…$ et $$…$$. Ce sont eux qui sont le plus largement pris en charge.

Les bouts de LaTeX dont tu auras besoin

Copie-les et change les lettres.

Tu veuxTu écris
Fraction\frac{a}{b}
Puissancex^2, et x^{10} pour plus d’un caractère
Indicex_1, et x_{max}
Racine carrée\sqrt{x}, et \sqrt[3]{x} pour une racine cubique
Lettres grecques\alpha \beta \pi \Delta
Somme\sum_{i=1}^{n} i
Intégrale\int_0^1 x\,dx
Texte dans une formule\text{speed}

Une matrice :

$$
\begin{pmatrix} a & b \\ c & d \end{pmatrix}
$$

Plusieurs lignes alignées sur le signe égal :

$$
\begin{aligned}
x + y &= 5 \\
x - y &= 1
\end{aligned}
$$

Le & marque le point où les lignes s’alignent. \\ commence une nouvelle ligne.

La chimie avec \ce{}

Les formules chimiques utilisent \ce{}. Cela vient du paquet mhchem. Place-le dans une formule :

$\ce{H2O}$ and $\ce{CrO4^2-}$

$$\ce{CH4 + 2O2 -> CO2 + 2H2O}$$

$$\ce{A <=> B}$$

Les nombres deviennent des indices, ^ indique une charge, -> dessine une flèche et <=> dessine une flèche d’équilibre. L’outil doit prendre en charge mhchem, ce qui n’est pas le cas de tous.

Erreurs courantes

Un signe dollar pour de l’argent. Deux prix sur une même ligne peuvent ressembler à une formule :

It costs $5 and the other costs $10.

Un outil qui lit les dollars simples peut traiter 5 and the other costs comme des mathématiques. Échappe chaque dollar monétaire avec une barre oblique inverse :

It costs \$5 and the other costs \$10.

Sur GitHub, tu peux aussi écrire <span>$</span>5. Dans une formule sur GitHub, une barre oblique inverse fonctionne : $\sqrt{\$4}$.

Des espaces juste à l’intérieur des dollars. Écris $x$, pas $ x $. Certains outils ne lisent pas une formule quand un espace suit le $ ouvrant. Garder la formule serrée évite le problème.

Une ligne vide dans une formule affichée. Une ligne vide termine un paragraphe, et de nombreux outils arrêtent alors de lire la formule. Garde tout le bloc $$ … $$ sur des lignes consécutives, sans ligne vide au milieu.

Une formule $$ collée au texte. Pour une formule affichée, mets $$ sur sa propre ligne, avec une ligne vide avant et après.

Lire des formules mathématiques dans Markdown

PilcrowMD compose les formules sur ton appareil. Il n’utilise ni Internet ni page web cachée.

Pour corriger une formule, passe à l’éditeur, modifie le LaTeX, puis reviens en arrière pour voir le résultat.

PilcrowMD pour Mac (bêta)

Questions fréquentes

Les formules de ChatGPT, Claude ou Gemini fonctionnent-elles dans Markdown ? Oui, si la réponse est enregistrée en Markdown et que ton lecteur connaît les délimiteurs utilisés. De nombreux assistants écrivent \( \) et \[ \]. Si ton lecteur ne connaît que les dollars, remplace-les par $…$ et $$…$$.

Quelle est la différence entre $ et $$ ? Un dollar de chaque côté donne une formule en ligne, dans la phrase. Deux dollars donnent une formule affichée, sur sa propre ligne.

Pourquoi ma formule s’affiche-t-elle en texte brut ? Les raisons les plus courantes sont un lecteur sans prise en charge des formules, des délimiteurs que le lecteur ne connaît pas, un espace juste à l’intérieur du $, ou une ligne vide dans une formule affichée. Vérifie-les dans cet ordre.

Aussi sur Mac : PilcrowMD pour Mac (bêta)