> 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/creer-du-contenu/blocks/hint.md).

# Encadrés

Ajoutez un encadré à une page pour attirer l’attention de vos lecteurs sur des informations importantes spécifiques.

Les encadrés, ou callouts, sont un excellent moyen d’attirer l’attention du lecteur sur des éléments spécifiques de votre documentation, tels que des conseils, des avertissements et d’autres informations importantes.

Il existe quatre styles d’encadré différents — vous pouvez changer le style en ouvrant le **menu Options** <picture><source srcset="/files/QLUQj6waZRiK6FpSqrt6" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FaS1QvPIBVYwhpFTGcPBN%2Foptions-menu.svg?alt=media&amp;token=3ee40bbf-f4fb-41fa-aa30-306b559cbe88" alt="The Options menu icon in GitBook"></picture> du bloc et en sélectionnant le style souhaité. Chaque style utilise une icône par défaut, mais vous pouvez personnaliser l’icône en cliquant dessus et en en choisissant une autre dans [notre jeu d’icônes](/docs/documentation/fr/creer-du-contenu/formatting/inline.md#icons).

Les blocs d’encadré prennent en charge [le contenu en ligne](/docs/documentation/fr/creer-du-contenu/formatting/inline.md) et [la mise en forme](/docs/documentation/fr/creer-du-contenu/formatting.md), ainsi que certains types de blocs spécifiques. Pour voir quels types de blocs vous pouvez utiliser dans un encadré, appuyez sur `/` sur une ligne vide et consultez la [palette d’insertion](/docs/documentation/fr/creer-du-contenu/blocks.md#inserting-a-new-content-block).

### Exemples de blocs d’encadré <a href="#example-of-a-hint" id="example-of-a-hint"></a>

{% hint style="info" %}
**Les encadrés d’information** sont parfaits pour afficher des informations générales ou fournir des conseils et astuces.
{% endhint %}

{% hint style="success" %}
**Les encadrés de succès** sont utiles pour afficher des actions positives ou des réussites.
{% endhint %}

{% hint style="warning" %}
**Les encadrés d’avertissement** sont utiles pour afficher des informations importantes ou des avertissements non critiques.
{% endhint %}

{% hint style="danger" %}
**Les encadrés de danger** sont utiles pour mettre en évidence des actions destructrices ou attirer l’attention sur des informations critiques.
{% endhint %}

{% hint style="info" icon="books" %}
Ce bloc d’encadré a une icône personnalisée.
{% endhint %}

{% hint style="info" %}

#### **Ceci est un titre H2**

Ceci est une ligne

Ceci est une image en ligne <img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F0FzoF68PAY3Rv297meNB%2Fcommand.svg?alt=media&amp;token=b07ff261-6e28-4879-8ab1-039a49f6ab41" alt="The Apple computer command icon" data-size="line"> image

* Ceci est une deuxième <mark style="color:orange;background-color:purple;">ligne utilisant une liste non ordonnée et la couleur</mark>
  {% endhint %}

Pour ajouter un titre à votre encadré, vous devez créer un bloc de titre comme premier bloc de l’encadré.

### Représentation en Markdown

```markdown
{% hint style="info" %}
**Les encadrés d’information** sont parfaits pour afficher des informations générales ou fournir des conseils et astuces.
{% endhint %}

{% hint style="success" %}
**Les encadrés de succès** sont utiles pour afficher des actions positives ou des réussites.
{% endhint %}

{% hint style="warning" %}
**Les encadrés d’avertissement** sont utiles pour afficher des informations importantes ou des avertissements non critiques.
{% endhint %}

{% hint style="danger" %}
**Les encadrés de danger** sont utiles pour mettre en évidence des actions destructrices ou attirer l’attention sur des informations critiques.
{% endhint %}

{% hint style="info" icon="books" %}
Ce bloc d’encadré a une icône personnalisée.
{% endhint %}

{% hint style="info" %}
## Ceci est un titre H2

Ceci est une ligne

Ceci est une image en ligne <img src="../../.gitbook/assets/25_01_10_command_icon_light.svg" alt="L’icône de commande de l’ordinateur Apple" data-size="line">

- Ceci est une deuxième <mark style="color:orange;background-color:purple;">ligne utilisant une liste non ordonnée et la couleur</mark>
{% 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/fr/creer-du-contenu/blocks/hint.md?ask=<question>&goal=<user_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.