> For the complete documentation index, see [llms.txt](https://smedai.aivd.ch/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smedai.aivd.ch/applications/gitbook/creer/blocs/titres.md).
# Titres
{% hint style="info" %}
Cette page vise des **contributeurs invités**.
Vous pouvez éditer le contenu d’un ou plusieurs espaces.
Vous n’avez généralement pas accès aux réglages d’**organisation**, de **site publié** ou de **mise en ligne**.
Pour ces sujets, contactez les responsables de l’espace ou l’équipe SIC.
{% endhint %}
Les titres aident à structurer vos documents — et l'utilisation de mots-clés dans les titres aidera également les moteurs de recherche à comprendre cette structure, ce qui peut améliorer le classement de votre page dans les résultats de recherche.
GitBook propose trois niveaux de titres. Les titres de niveau 1 (H1) et 2 (H2) apparaîtront dans le plan de la page (voir aussi [Documentation GitBook](/applications/gitbook/readme.md#cest-quoi-gitbook)).
### Liens d'ancrage
Lorsque vous ajoutez un titre à une page, cela crée un lien d'ancrage. Vous pouvez ensuite lier directement ces sections spécifiques pour orienter les personnes vers des informations pertinentes.
#### Lier à un ancrage
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 faire référence à un ancrage particulier depuis une page de votre espace GitBook, vous pouvez utiliser un [lien relatif](/applications/gitbook/creer/mise-en-forme-de-votre-contenu/contenu-en-ligne.md#liens-relatifs), qui se mettra à jour si vous changez le titre afin d'éviter que le lien ne soit rompu.
#### Modifier un ancrage
Par défaut, le lien d'ancrage sera identique au texte de votre en-tête. Si vous prévoyez de lier cette URL en dehors de GitBook, modifier le titre ultérieurement rompra le lien d'ancrage. Le lien emmènera alors les visiteurs en haut de la page, plutôt qu'à l'emplacement de l'ancrage.
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'ancrage**. Vous pouvez ensuite saisir le lien d'ancrage que vous souhaitez utiliser — il restera l'ancrage 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 référencement, ce qui signifie que les titres de pages dans GitBook sont automatiquement représentés en markdown comme un titre de premier niveau :
```markdown
# Je suis un titre de page
```
Les en-têtes de page ajoutés via l'éditeur seront représentés comme un niveau inférieur :
{% code overflow="wrap" %}
```markdown
## Mon titre 1
### Mon titre 2
#### Mon titre 3
```
{% endcode %}
### Exemples de titres
## Mon titre 1
### Mon titre 2
#### Mon titre 3
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://smedai.aivd.ch/applications/gitbook/creer/blocs/titres.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.