Formules en ligne et formules affichées
Il y a deux sortes de formules :
- En ligne : placée dans une phrase, avec les mots.
- Affichée : placée sur sa propre ligne, généralement plus grande et centrée.
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élimiteurs | Type | Exemple |
|---|---|---|
$…$ | 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.
- GitHub lit
$…$et$$…$$. Il a aussi un bloc délimité qui n’a pas besoin de dollars :
```math
\sum_{k=1}^n k = \frac{n(n+1)}{2}
```
- De nombreux chats IA écrivent
\( \)et\[ \]dans leurs réponses. Si tu colles cela dans un outil qui ne lit que les dollars, tu vois du code brut. Remplace les délimiteurs à la main. - Les outils web dépendent de leur configuration. Le rendu automatique de KaTeX, par exemple, lit
$$,\( \)et\[ \]par défaut, mais le$simple doit être activé.
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 veux | Tu écris |
|---|---|
| Fraction | \frac{a}{b} |
| Puissance | x^2, et x^{10} pour plus d’un caractère |
| Indice | x_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.
- Android : lit
$…$et$$…$$. Une formule$…$reste dans la phrase. Une formule$$…$$sur sa propre ligne devient une formule affichée ;$$…$$au milieu d’une phrase reste dans la phrase. La chimie avec\ce{}fonctionne aussi, de même que les formules dans les cellules de tableau. Si une réponse d’IA utilise\( \)ou\[ \], remplace-les d’abord par des dollars. - Mac : lit
$et$$, ainsi que\( \)et\[ \].\ce{}et les formules dans les cellules de tableau fonctionnent aussi ici. Si l’application ne peut pas dessiner une formule, elle affiche le texte source à la place, donc rien n’est perdu.
Pour corriger une formule, passe à l’éditeur, modifie le LaTeX, puis reviens en arrière pour voir le résultat.
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)