> 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/formatting/markdown.md).

# Markdown

Rédigez directement en Markdown dans l’éditeur pour créer facilement du contenu à l’aide d’une syntaxe courante

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FMbo91kXRJGPsIzXxsgpU%2Fmarkdown%402x.png?alt=media&amp;token=9d812c93-81df-4bca-a053-baa88d83f572" alt="An image containing the markdown logo"><figcaption><p>Écrivez en Markdown dans GitBook.</p></figcaption></figure>

L’éditeur de GitBook vous permet de créer du contenu mis en forme à l’aide de Markdown.

Markdown est une syntaxe de balisage populaire, largement connue pour sa simplicité. GitBook le prend en charge comme un moyen convivial au clavier d’écrire du texte riche et structuré.

{% hint style="info" %}
Vous pouvez en apprendre davantage sur Markdown en visitant [Common Mark](https://commonmark.org/help/).
{% endhint %}

### Mise en forme du texte <a href="#text-formatting" id="text-formatting"></a>

GitBook prend en charge toute la mise en forme Markdown inline classique :

| Mise en forme | Version Markdown | Résultat   |
| ------------- | ---------------- | ---------- |
| Gras          | `**gras**`       | **gras**   |
| Italique      | `_italique_`     | *italique* |
| Barré         | `~barré~`        | ~~barré~~  |
| Code en ligne | `` `code` ``     | `code`     |

### Sauts de ligne

Appuyez sur `Enter` pour commencer un nouveau paragraphe.

Appuyez sur `Maj` + `Enter` pour insérer un saut de ligne souple dans le même paragraphe.

### Coller du Markdown

Lorsque vous collez directement du contenu Markdown dans l’éditeur, il est important d’utiliser l’ **Coller et assortir le style** option (généralement <kbd>Maj</kbd> + <kbd>Cmd</kbd> + <kbd>V</kbd> sur Mac ou <kbd>Maj</kbd> + <kbd>Ctrl</kbd> + <kbd>V</kbd> sur Windows).

Si vous utilisez l’option Coller standard pour du contenu copié depuis un autre éditeur ou depuis le web, il peut être inséré sous forme de bloc de code au lieu de texte mis en forme.

### Titres

* Titre 1 : `# Un titre de premier niveau`
* Titre 2 : `## Un titre de deuxième niveau`
* Titre 3 : `### Un titre de troisième niveau`

### Blocs de code

` ```⏎ ` crée un nouveau bloc de code.

` ```py⏎ ` crée un nouveau bloc de code avec la coloration syntaxique Python.

Nous utilisons [Prism](https://github.com/PrismJS/prism) pour la coloration syntaxique. Utilisez [Test Drive Prism](https://prismjs.com/test.html#language=markup) pour vérifier les langages pris en charge.

Si GitBook et Prism diffèrent, il se peut que nous ayons une ou deux versions de retard.

### Listes

GitBook détecte et crée automatiquement des listes ordonnées et non ordonnées au fur et à mesure que vous tapez.

* Commencez une ligne par `-` ou `*` pour commencer une liste à puces non ordonnée.
* Commencez une ligne par `1.` pour commencer une liste numérotée.
* Commencez une ligne par `- [ ]` pour commencer une liste de tâches.

Lorsque vous rédigez des listes, appuyez sur `Tab` pour augmenter le retrait, et `Maj+Tab` pour diminuer le retrait.

### Citations

Commencez une ligne par `>` pour créer une citation en bloc. Si vous sélectionnez un paragraphe entier du début à la fin, en tapant `>` vous envelopperez le contenu dans une citation en bloc.

> Ceci est une citation en bloc.

### Séparateurs

Tapez `---` puis appuyez sur `Enter` pour créer un séparateur sur votre page.

***

Voici un exemple de séparateur.


---

# 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/creer-du-contenu/formatting/markdown.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.
