> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-add-hello-world-quickstart-48843.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Titres et texte

> Apprenez à formater le texte, à créer des titres et à styliser le contenu

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

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

<div id="creating-headers">
  ### Création d’en-têtes
</div>

Utilisez le symbole `#` pour créer des en‑têtes de différents niveaux :

```mdx
## Titre de section principal
### Titre de sous-section
#### Titre de sous-sous-section
```

<Tip>
  Utilisez des titres descriptifs, riches en mots-clés, qui annoncent clairement le contenu à venir. Cela améliore la navigation des utilisateurs et le référencement (SEO).
</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 de pointer directement vers des sections spécifiques. Vous pouvez désactiver ces liens à l’aide de la prop `noAnchor` dans les en-têtes HTML ou React.

<CodeGroup>
  ```mdx HTML header example
  <h2 noAnchor>
  En-tête sans lien d’ancrage
  </h2>
  ```

  ```mdx React header example
  <Heading level={2} noAnchor>
  En-tête sans lien d’ancrage
  </Heading>
  ```
</CodeGroup>

Lorsque `noAnchor` est utilisé, l’en-tête n’affiche pas la puce d’ancrage et cliquer 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 syntaxes Markdown pour l’accentuation et la mise en forme 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**   | `**texte**` | `**note importante**` | **note importante**   |
| *Italique* | `_texte_`   | `_emphase_`           | *emphase*             |
| ~~Barré~~  | `~texte~`   | `~fonction obsolète~` | ~~fonction obsolète~~ |

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

Vous pouvez combiner des styles de mise en forme :

```mdx
**_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 en utilisant des chemins relatifs à la racine :

```mdx
[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, indiquez l’URL complète :

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

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

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

Vous pouvez vérifier les liens cassés dans votre documentation à l’aide de la [CLI](/fr/installation) :

```bash
mint liens brisés
```

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

Les blocs de citation mettent en valeur 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
> Cette citation se distingue du contenu principal.
```

> Cette citation met en évidence un élément distinct du contenu principal.

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

Pour des citations plus longues ou comportant plusieurs paragraphes :

```mdx
> Voici le premier paragraphe d’une citation sur plusieurs lignes.
>
> Voici le deuxième paragraphe, séparé par une ligne vide avec « > ».
```

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

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

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

Nous prenons en charge LaTeX pour le rendu des expressions et é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
Le théorème de Pythagore énonce que, dans un triangle rectangle, on a $(a^2 + b^2 = c^2)$.
```

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 des doubles signes dollar, `$$`, pour les équations isolées :

```mdx
$$
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 sur la syntaxe.
</Info>

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

Maîtrisez les espaces 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
Ceci est le premier paragraphe.

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

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
Cette ligne se termine ici.<br />
Cette ligne commence à la ligne suivante.
```

Cette ligne se termine ici.<br />
Cette ligne commence à la ligne suivante.

<Tip>
  Dans la plupart des cas, des sauts de paragraphe séparés par des lignes vides offrent une meilleure 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 en-têtes pour établir une hiérarchie de contenu claire
* Respectez la hiérarchie des en-têtes (ne passez pas de H2 à H4)
* Rédigez des titres d’en-tête descriptifs et riches en mots-clés

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

* Utilisez le gras pour mettre en avant, pas pour des paragraphes entiers
* Réservez l’italique aux termes, aux titres ou à une emphase subtile
* Évitez la surmise en forme qui détourne de l’essentiel

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

* Préférez un texte de lien descriptif à « cliquez ici » ou « en savoir plus »
* Utilisez des chemins relatifs à la racine pour les liens internes
* Vérifiez régulièrement les liens afin d’éviter les liens brisés