# Markdown

<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&#x26;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 une manière pratique au clavier d’écrire du texte riche et structuré.

{% hint style="info" %}
Vous pouvez en savoir plus sur Markdown en visitant [CommonMark](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 classique en ligne :

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

### Coller du Markdown

Lorsque vous collez du contenu Markdown directement dans l’éditeur, il est important d’utiliser l’ **Coller et faire correspondre 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 de collage 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 de niveau 1 : `# Un titre de premier niveau`
* Titre de niveau 2 : `## Un titre de deuxième niveau`
* Titre de niveau 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 coloration syntaxique Python.

{% hint style="info" %}
Nous utilisons [Prism](https://github.com/PrismJS/prism) pour la coloration syntaxique. Vous pouvez utiliser [Test Drive Prism](https://prismjs.com/test.html#language=markup) pour vérifier les langages pris en charge par Prism. Si vous remarquez une différence entre GitBook et Prism, il est possible que nous ayons une ou deux versions de retard. Nous rattraperons vite notre retard !
{% endhint %}

### 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.

{% hint style="info" %}
Lorsque vous rédigez n’importe quel type de liste, appuyez sur `Tabulation` pour ajouter une indentation, et `Maj+Tab` pour réduire l’indentation.&#x20;
{% endhint %}

### 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 `Entrée` pour créer un séparateur sur votre page.

***

Voici un exemple de séparateur.
