> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/creating-content/blocks/heading.md).

# Titres

Les titres aident à donner une structure à vos documents — et l’utilisation de mots-clés dans les titres aidera également les moteurs de recherche à comprendre cette structure, ce qui peut aider votre page à mieux se classer 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 page](/docs/documentation/fr/ressources/gitbook-ui.md#page-outline).

### Liens d’ancrage

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

#### 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 section, vous pouvez utiliser un [lien relatif](/docs/documentation/fr/creating-content/formatting/inline.md#relative-links) , qui sera mis à jour si vous modifiez le titre afin d’éviter que le lien ne se casse.

#### Modifier une ancre

Par défaut, le lien d’ancrage sera identique au texte de votre en-tête. Si vous prévoyez de créer un lien vers cette URL en dehors de GitBook, modifier l’en-tête à l’avenir cassera le lien d’ancrage. Le lien redirigera 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 des options** <picture><source srcset="/files/QLUQj6waZRiK6FpSqrt6" media="(prefers-color-scheme: dark)"><img src="/files/a8fb7b2b9f8482b7286cc5fc535d675ecfc5a7d9" alt="The Options menu icon in GitBook"></picture> du titre, 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 le titre 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 sous la forme d’un titre de premier niveau :

```markdown
# Je suis un titre de page
```

Cela signifie que si vous [synchronisez votre contenu avec Git](/docs/documentation/fr/getting-started/git-sync.md), les en-têtes de page ajoutés via l’éditeur seront représentés avec un niveau de moins :

{% code overflow="wrap" %}

```markdown
## Mon titre 1
### Mon titre 2
#### Mon titre 3
```

{% endcode %}

### Exemples de titres <a href="#example-of-a-heading" id="example-of-a-heading"></a>

## Mon titre 1

### Mon titre 2

#### Mon titre 3

{% hint style="info" %}
Les titres de page sont distincts des blocs de titre dans le corps de la page. Si vous masquez le titre de la page dans **Options de page**, vos titres H1, H2 et H3 apparaissent quand même.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/documentation/fr/creating-content/blocks/heading.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
