Écriture d’expressions mathématiques

Utilisez Markdown pour afficher des expressions mathématiques sur GitHub.

Qui peut utiliser cette fonctionnalité ?

Markdown peut être utilisé dans l’interface web GitHub.

Dans cet article

À propos de l’écriture d’expressions mathématiques

Pour permettre une communication claire des expressions mathématiques, GitHub prend en charge les mathématiques au format LaTeX dans Markdown. Pour plus d’informations, consultez LaTeX/Mathematics dans Wikibooks.

La capacité de rendu mathématique de GitHub utilise MathJax, un moteur d'affichage open source basé sur JavaScript. MathJax prend en charge un large éventail de macros LaTeX et plusieurs extensions d’accessibilité utiles. Pour plus d’informations, consultez la documentation MathJax et la documentation sur les extensions d’accessibilité MathJax.

Le rendu des expressions mathématiques est disponible dans GitHub Issues, GitHub Discussions, les demandes de tirage, les wikis et les fichiers Markdown.

Écriture d’expressions inlined

Il existe deux options pour délimiter une expression mathématique en ligne avec votre texte. Vous pouvez entourer l’expression de symboles dollar ($), ou commencer l’expression par $` et la terminer par `$. Cette dernière syntaxe est utile lorsque l’expression que vous écrivez contient des caractères qui chevauchent la syntaxe Markdown. Pour plus d’informations, consultez « Syntaxe de base pour l’écriture et la mise en forme ».

This sentence uses `$` delimiters to show math inline: $\sqrt{3x-1}+(1+x)^2$

Capture d'écran d'un rendu Markdown montrant une expression mathématique en ligne : la racine carrée de 3x moins 1 plus (1 plus x) au carré.

This sentence uses $\` and \`$ delimiters to show math inline: $`\sqrt{3x-1}+(1+x)^2`$

Capture d'écran d'un rendu Markdown montrant une expression mathématique en ligne avec la syntaxe backtick : la racine carrée de 3x moins 1 plus (1 plus x) au carré.

Écriture d’expressions en tant que blocs

Pour ajouter une expression mathématique en tant que bloc, démarrez une nouvelle ligne et délimitez l’expression avec deux symboles du dollar $$.

Tip

Si vous écrivez dans un fichier .md, vous devrez utiliser un formatage spécifique pour créer un saut de ligne, par exemple en terminant la ligne par une barre oblique inverse, comme indiqué dans l'exemple ci-dessous. Pour plus d’informations sur l’utilisation d’images dans Markdown, consultez Syntaxe de base pour l’écriture et la mise en forme.

**The Cauchy-Schwarz Inequality**\
$$\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)$$

Capture d'écran d'un rendu Markdown montrant une équation complexe. Le texte en gras indique « L'inégalité de Cauchy-Schwarz » au-dessus de la formule de l'inégalité.

Vous pouvez également utiliser la syntaxe de bloc de code ```math pour afficher une expression mathématique en tant que bloc. Avec cette syntaxe, vous n’avez pas besoin d’utiliser des délimiteurs $$. Le rendu suivant est identique à celui ci-dessus :

**The Cauchy-Schwarz Inequality**

```math
\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)
```

Écriture de signes dollar en ligne avec et dans les expressions mathématiques

Pour afficher un signe dollar sous la forme d’un caractère dans la même ligne qu’une expression mathématique, vous devez échapper au $ non délimiteur pour vous assurer que la ligne s’affiche correctement.

  • Dans une expression mathématique, ajoutez un symbole \ avant $ explicite.

    This expression uses `\$` to display a dollar sign: $`\sqrt{\$4}`$

    Capture d’écran du Markdown rendu montrant comment une barre oblique inverse devant un signe dollar affiche le signe dans le cadre d’une expression mathématique.

  • En dehors d’une expression mathématique, mais sur la même ligne, utilisez des balises d’étendue autour de $ explicite.

    To split <span>$</span>100 in half, we calculate $100/2$

    Capture d'écran d'un rendu Markdown montrant comment les balises span autour d'un signe dollar affichent le signe comme un texte en ligne et non comme une partie d'une équation mathématique.

Pour aller plus loin