> 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
Écrivez du Markdown dans GitBook.
L’éditeur de GitBook vous permet de créer du contenu formaté à 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 lui-même en visitant [CommonMark](https://commonmark.org/help/).
{% endhint %}
### Mise en forme du texte
GitBook prend en charge toute la mise en forme Markdown classique en ligne :
| Mise en forme | Version Markdown | Résultat |
| ------------- | ----------------- | ---------- |
| Gras | `**bold**` | **gras** |
| Italique | `_italic_` | *italique* |
| Barré | `~strikethrough~` | ~~barré~~ |
| Code en ligne | `` `code` `` | `code` |
### Sauts de ligne
Appuyez sur `Entrée` pour commencer un nouveau paragraphe.
Appuyez sur `Shift` + `Entrée` pour insérer un retour à la ligne souple dans le même paragraphe.
### Coller du Markdown
Lorsque vous collez du contenu Markdown directement dans l’éditeur, il est important d’utiliser l’option **Coller et adapter le style** option (généralement Shift + Cmd + V sur Mac ou Shift + Ctrl + V 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é en tant que bloc de code plutôt qu’en texte formaté.
### Titres
* Titre 1 : `# Un titre de premier niveau`
* Titre 2 : `## Un titre de second 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 indenter, et `Maj+Tab` pour désindenter.
### Citations
Commencez une ligne par `>` pour créer un bloc de citation. Si vous sélectionnez un paragraphe entier du début à la fin, la saisie de `>` enveloppera le contenu dans un bloc de citation.
> Ceci est un bloc de citation.
### Séparateurs
Tapez `---` puis appuyez sur `Entrée` 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=&goal=
```
`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.