En-têtes et texte

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

​

En-têtes

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.

​

Créer des en-têtes

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

## En-tête de section principale
### En-tête de sous-section
#### En-tête de sous-sous-section

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.

​

Désactivation des liens d’ancrage

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.

HTML header example

<h2 noAnchor>
Header without anchor link
</h2>

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.

​

Mise en forme du texte

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

​

Mise en forme de base

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

​

Combiner des formats

Vous pouvez combiner les styles de mise en forme :

**_gras et italique_**
**~~gras et barré~~**
*~~italique et barré~~**

gras et italique
gras et barré
italique et barré

​

Exposant et indice

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>	example2
Indice	<sub>text</sub>	example<sub>n</sub>	examplen

​

Liens

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.

​

Liens internes

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

[Démarrage rapide](/quickstart)
[Étapes](/components/steps)

Démarrage rapide
Étapes

É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.

​

Liens externes

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

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

Guide Markdown

​

Liens cassés

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

mint broken-links

​

Blocs de citation

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

​

Bloc de citation sur une seule ligne

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

> Ceci est une citation qui se distingue du contenu principal.

Cette citation se détache du contenu principal.

​

Citations sur plusieurs lignes

Pour des citations plus longues ou comportant plusieurs paragraphes :

> 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 >.

Utilisez les blocs de citation avec parcimonie pour préserver leur impact visuel et leur pertinence. Envisagez d’utiliser des encadrés pour les notes, les avertissements et autres informations.

​

Expressions mathématiques

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

​

Mathématiques en ligne

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

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.

​

Équations en bloc

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

$$
E = mc^2
$$

$$E = mc^2$$

La prise en charge de LaTeX nécessite une syntaxe mathématique correcte. Consultez la documentation LaTeX pour des recommandations complètes en matière de syntaxe.

​

Sauts de ligne et espacement

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

​

Sauts de paragraphe

Séparez les paragraphes par des lignes vides :

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.

​

Sauts de ligne manuels

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

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

Cette ligne se termine ici.
Cette ligne commence sur une nouvelle ligne.

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.

​

Bonnes pratiques

​

Organisation du contenu

• 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

​

Mise en forme du texte

• 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

​

Liens

• 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