> ## Documentation Index
> Fetch the complete documentation index at: https://omer-914cc1c6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# En-têtes et texte

> Apprenez à mettre en forme le texte, à créer des en-têtes et à styliser le contenu

<div id="headers">
  ## En-têtes
</div>

Les en-têtes organisent votre contenu et créent des ancres de navigation. Ils apparaissent dans la table des matières et aident les utilisateurs à parcourir votre documentation.

<div id="creating-headers">
  ### Créer des en-têtes
</div>

Utilisez les symboles `#` pour créer des en-têtes de différents niveaux :

```mdx theme={null}
## En-tête de section principale
### En-tête de sous-section
#### En-tête de sous-sous-section
```

<Tip>
  Utilisez des titres descriptifs, riches en mots-clés, qui indiquent clairement le contenu à venir. Cela améliore à la fois la navigation des utilisateurs et le référencement.
</Tip>

<div id="disabling-anchor-links">
  ### Désactivation des liens d’ancrage
</div>

Par défaut, les en-têtes incluent des liens d’ancrage cliquables permettant aux utilisateurs de renvoyer directement vers des sections spécifiques. Vous pouvez désactiver ces liens d’ancrage à l’aide de la prop `noAnchor` dans les en-têtes HTML ou React.

<CodeGroup>
  ```mdx HTML header example theme={null}
  <h2 noAnchor>
  Header without anchor link
  </h2>
  ```

  ```mdx React header example theme={null}
  <Heading level={2} noAnchor>
  Header without anchor link
  </Heading>
  ```
</CodeGroup>

Lorsque `noAnchor` est utilisé, l’en-tête n’affiche pas la puce d’ancrage et un clic sur le texte de l’en-tête ne copie pas le lien d’ancrage dans le presse-papiers.

<div id="text-formatting">
  ## Mise en forme du texte
</div>

Nous prenons en charge la plupart des formats Markdown pour l’emphase et le style du texte.

<div id="basic-formatting">
  ### Mise en forme de base
</div>

Appliquez ces styles de mise en forme à votre texte :

| Style      | Syntaxe    | Exemple                     | Résultat                    |
| ---------- | ---------- | --------------------------- | --------------------------- |
| **Gras**   | `**text**` | `**note importante**`       | **note importante**         |
| *Italique* | `_text_`   | `_mise en évidence_`        | *mise en évidence*          |
| ~~Barré~~  | `~text~`   | `~fonctionnalité obsolète~` | ~~fonctionnalité obsolète~~ |

<div id="combining-formats">
  ### Combiner des formats
</div>

Vous pouvez combiner les styles de mise en forme :

```mdx theme={null}
**_gras et italique_**
**~~gras et barré~~**
*~~italique et barré~~**
```

***gras et italique***<br />
**~~gras et barré~~**<br />
*~~italique et barré~~*

<div id="superscript-and-subscript">
  ### Exposant et indice
</div>

Pour les expressions mathématiques ou les notes de bas de page, utilisez des balises HTML :

| Type     | Syntaxe           | Exemple               | Résultat            |
| -------- | ----------------- | --------------------- | ------------------- |
| Exposant | `<sup>text</sup>` | `example<sup>2</sup>` | example<sup>2</sup> |
| Indice   | `<sub>text</sub>` | `example<sub>n</sub>` | example<sub>n</sub> |

<div id="links">
  ## Liens
</div>

Les liens aident les utilisateurs à naviguer entre les pages et à accéder à des ressources externes. Utilisez un libellé de lien descriptif pour améliorer l’accessibilité et l’expérience utilisateur.

<div id="internal-links">
  ### Liens internes
</div>

Créez des liens vers d’autres pages de votre documentation à l’aide de chemins relatifs à la racine :

```mdx theme={null}
[Démarrage rapide](/quickstart)
[Étapes](/components/steps)
```

[Démarrage rapide](/fr/quickstart)<br />
[Étapes](/fr/components/steps)

<Note>
  Évitez les liens relatifs comme `[page](../page)`, car ils se chargent plus lentement et ne peuvent pas être optimisés aussi efficacement que les liens relatifs à la racine.
</Note>

<div id="external-links">
  ### Liens externes
</div>

Pour les ressources externes, incluez l’URL complète :

```mdx theme={null}
[Guide Markdown](https://www.markdownguide.org/)
```

[Guide Markdown](https://www.markdownguide.org/)

<div id="broken-links">
  ### Liens cassés
</div>

Vous pouvez vérifier la présence de liens cassés dans votre documentation à l’aide de l’interface en ligne de commande (CLI) : [/installation](/fr/installation)

```bash theme={null}
mint broken-links
```

<div id="blockquotes">
  ## Blocs de citation
</div>

Les blocs de citation mettent en avant des informations importantes, des citations ou des exemples dans votre contenu.

<div id="single-line-blockquotes">
  ### Bloc de citation sur une seule ligne
</div>

Ajoutez `>` avant le texte pour créer un bloc de citation :

```mdx theme={null}
> Ceci est une citation qui se distingue du contenu principal.
```

> Cette citation se détache du contenu principal.

<div id="multi-line-blockquotes">
  ### Citations sur plusieurs lignes
</div>

Pour des citations plus longues ou comportant plusieurs paragraphes :

```mdx theme={null}
> Ceci est le premier paragraphe d'une citation multiligne.
>
> Ceci est le second paragraphe, séparé par une ligne vide avec `>`.
```

> Voici le premier paragraphe d’un bloc de citation multilignes.
>
> Voici le deuxième paragraphe, séparé par une ligne vide précédée de `>`.

<Tip>
  Utilisez les blocs de citation avec parcimonie pour préserver leur impact visuel et leur pertinence. Envisagez d’utiliser des [encadrés](/fr/components/callouts) pour les notes, les avertissements et autres informations.
</Tip>

<div id="mathematical-expressions">
  ## Expressions mathématiques
</div>

Nous prenons en charge LaTeX pour l’affichage des expressions et des équations mathématiques.

<div id="inline-math">
  ### Mathématiques en ligne
</div>

Utilisez un seul signe dollar, `$`, pour les expressions mathématiques en ligne :

```mdx theme={null}
Le théorème de Pythagore énonce que $(a^2 + b^2 = c^2)$ dans un triangle rectangle.
```

Le théorème de Pythagore énonce que $(a^2 + b^2 = c^2)$ dans un triangle rectangle.

<div id="block-equations">
  ### Équations en bloc
</div>

Utilisez deux signes dollar, `$$`, pour des équations indépendantes :

```mdx theme={null}
$$
E = mc^2
$$
```

$$
E = mc^2
$$

<Info>
  La prise en charge de LaTeX nécessite une syntaxe mathématique correcte. Consultez la [documentation LaTeX](https://www.latex-project.org/help/documentation/) pour des recommandations complètes en matière de syntaxe.
</Info>

<div id="line-breaks-and-spacing">
  ## Sauts de ligne et espacement
</div>

Contrôlez l’espacement et les retours à la ligne pour améliorer la lisibilité du contenu.

<div id="paragraph-breaks">
  ### Sauts de paragraphe
</div>

Séparez les paragraphes par des lignes vides :

```mdx theme={null}
Ceci est le premier paragraphe.

Ceci est le deuxième paragraphe, séparé par une ligne vide.
```

Ceci est le premier paragraphe.

Ceci est le deuxième paragraphe, séparé par une ligne blanche.

<div id="manual-line-breaks">
  ### Sauts de ligne manuels
</div>

Utilisez les balises HTML `<br />` pour imposer des retours à la ligne à l’intérieur des paragraphes :

```mdx theme={null}
Cette ligne se termine ici.<br />
Cette ligne commence sur une nouvelle ligne.
```

Cette ligne se termine ici.<br />
Cette ligne commence sur une nouvelle ligne.

<Tip>
  Dans la plupart des cas, des sauts de paragraphe séparés par des lignes vides améliorent davantage la lisibilité que des retours à la ligne manuels.
</Tip>

<div id="best-practices">
  ## Bonnes pratiques
</div>

<div id="content-organization">
  ### Organisation du contenu
</div>

* Utilisez des titres pour créer une hiérarchie de contenu claire
* Respectez une hiérarchie de titres cohérente (ne passez pas de H2 à H4)
* Rédigez des titres descriptifs et riches en mots-clés

<div id="text-formatting">
  ### Mise en forme du texte
</div>

* Utilisez le gras pour mettre en évidence, pas pour des paragraphes entiers
* Réservez l’italique aux termes, aux titres ou à une mise en relief subtile
* Évitez la surmise en forme qui détourne l’attention du contenu

<div id="links">
  ### Liens
</div>

* Rédigez un texte de lien descriptif plutôt que « cliquez ici » ou « en savoir plus »
* Utilisez des chemins relatifs à la racine pour les liens internes
* Testez régulièrement les liens pour éviter les liens cassés