Titres

Ajoutez des blocs de titre à une page pour organiser votre contenu et améliorer le SEO

Les titres aident à donner une structure à vos documents — et l’utilisation de mots-clés dans les titres aide aussi les moteurs de recherche à comprendre cette structure, ce qui peut contribuer à mieux positionner votre page dans les résultats de recherche.

GitBook propose trois niveaux de titres. Les niveaux de titre 1 (H1) et 2 (H2) apparaîtront dans le plan de la page.

Liens d’ancrage

Lorsque vous ajoutez un titre à une page, cela crée un lien d’ancrage. Vous pouvez ensuite créer des liens directement vers ces sections spécifiques, afin de diriger les personnes vers les informations pertinentes.

Créer un lien vers une ancre

Vous pouvez voir les liens d’ancrage dans le contenu public, ou dans le contenu privé en mode lecture seule, en survolant le titre et en cliquant sur le # qui apparaît à côté. Cela mettra à jour l’URL dans la barre supérieure de votre navigateur, afin que vous puissiez la copier pour l’utiliser ailleurs.

Si vous souhaitez créer un lien vers une ancre particulière depuis une page de votre espace GitBook, vous pouvez utiliser un lien relatif, qui sera mis à jour si vous modifiez le titre afin d’éviter que le lien ne soit rompu.

Modifier une ancre

Par défaut, le lien d’ancrage sera identique au texte de votre en-tête. Si vous prévoyez de faire un lien vers cette URL en dehors de GitBook, la modification future de l’en-tête rompra le lien d’ancrage. Le lien dirigera alors les visiteurs vers le haut de la page, plutôt que vers l’emplacement de l’ancre.

Pour éviter cela, vous pouvez définir manuellement le lien d’ancrage en ouvrant le menu Options pour l’en-tête, puis en choisissant Modifier l’ancre. Vous pouvez ensuite saisir le lien d’ancrage que vous souhaitez utiliser — il restera l’ancre même si vous modifiez l’en-tête lui-même.

Représentation en Markdown

GitBook génère des pages optimisées pour le SEO, ce qui signifie que les titres de page dans GitBook sont automatiquement représentés en markdown comme un titre de premier niveau :

# Je suis un titre de page

Cela signifie que si vous synchronisez votre contenu avec Git, les en-têtes de page ajoutés via l’éditeur seront représentés d’un niveau inférieur :

## Mon titre 1
### Mon titre 2
#### Mon titre 3

Exemples de titres

Mon titre 1

Mon titre 2

Mon titre 3