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 la prend en charge comme un moyen de rédiger du texte riche et structuré au clavier.
{% hint style="info" %}
Vous pouvez en savoir plus sur Markdown en visitant [Balise courante](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 | `**gras**` | **gras** |
| Italique | `_italique_` | *italique* |
| Barré | `~barré~` | ~~barré~~ |
| Code en ligne | `` `code` `` | `code` |
### Sauts de ligne
Appuyez sur `Entrée` pour commencer un nouveau paragraphe.
Appuyez sur `Maj` + `Entrée` pour insérer un saut de 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** (généralement Maj + Cmd + V sur Mac ou Maj + 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é sous forme de bloc de code au lieu d’un 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 langues prises 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 avec `-` ou `*` pour commencer une liste à puces non ordonnée.
* Commencez une ligne avec `1.` pour commencer une liste numérotée.
* Commencez une ligne avec `- [ ]` pour commencer une liste de tâches.
Lorsque vous rédigez des listes, appuyez sur `Tab` pour indenter, et `Shift+Tab` pour désindenter.
### Citations
Commencez une ligne avec `>` pour créer une citation en bloc. Si vous sélectionnez un paragraphe entier du début à la fin, le fait de taper `>` encadrera le contenu dans une citation en bloc.
> Ceci est une citation en bloc.
### 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: 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:
```
GET https://gitbook.com/docs/documentation/fr/creating-content/formatting/markdown.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.