Aide-mémoire Markdown

Markdown est une façon simple de mettre en forme du texte qui s’affiche parfaitement sur n’importe quel appareil. Il ne fait rien de compliqué comme changer la taille, la couleur ou le type de police – juste l’essentiel, avec des symboles du clavier que vous connaissez déjà. Voici la référence complète : chaque règle présentée à côté de son résultat rendu.

Titres

Utilisez des symboles # devant votre texte – un seul # pour le plus grand titre, jusqu’à six pour le plus petit. Les deux premiers niveaux ont aussi un style « souligné ».

Markdown	Résultat
`# Titre 1 Titre 1 =========`	Titre 1
`## Titre 2 Titre 2 ---------`	Titre 2
`### Titre 3`	Titre 3
`#### Titre 4`	Titre 4
`##### Titre 5`	Titre 5
`###### Titre 6`	Titre 6

Emphase

Entourez le texte de symboles pour le mettre en gras, en italique ou ~~barré~~. Les astérisques et les tirets bas fonctionnent de la même manière.

Markdown	Résultat
`Italique _Italique_`	Italique
`Gras __Gras__`	Gras
`*Gras & italique*`	*Gras & italique*
`~~Barré~~`	~~Barré~~

Citations

Commencez une ligne par > pour citer du texte. Ajoutez un autre > pour imbriquer les citations, et des lignes > vides pour séparer les paragraphes.

Markdown	Résultat
`> Ceci est une citation.`	Ceci est une citation.
`> Premier paragraphe. > > Deuxième paragraphe.`	Premier paragraphe. Deuxième paragraphe.
`> Niveau un >> Niveau deux`	Niveau un Niveau deux

Listes

Les listes à puces commencent par -, * ou +. Les listes numérotées utilisent 1., 2., 3. Indentez de deux espaces pour imbriquer une sous-liste.

Markdown	Résultat
`- Premier élément - Deuxième élément - Troisième élément`	Premier élément Deuxième élément Troisième élément
`1. Premier élément 2. Deuxième élément 3. Troisième élément`	Premier élément Deuxième élément Troisième élément
`1. Premier élément - Sous-élément - Sous-élément 2. Deuxième élément`	Premier élément Sous-élément Sous-élément Deuxième élément

Listes de tâches

Ajoutez [ ] pour une case vide ou [x] pour une case cochée juste après la puce. Idéal pour les listes de tâches sur GitHub.

Markdown	Résultat
`- [x] Apprendre Markdown - [ ] Maîtriser Markdown - [ ] Enseigner à un ami`	Apprendre Markdown Maîtriser Markdown Enseigner à un ami

Liens

Placez le texte visible dans [ ] et l’adresse dans ( ). Les liens de référence gardent l’adresse en bas, et les URL brutes deviennent automatiquement des liens.

Markdown	Résultat
`[Markdown69](https://markdown69.com)`	Markdown69
`[Survolez-moi](https://markdown69.com "Meilleur aide-mémoire")`	Survolez-moi
`[Lien de référence][site] [site]: https://markdown69.com`	Lien de référence
`<https://markdown69.com>`	https://markdown69.com
`[Aller en haut](#top)`	Aller en haut

Images

Comme les liens, avec un ! devant. Le texte dans [ ] devient le texte alternatif affiché lorsque l’image ne peut pas se charger.

Markdown	Résultat
`![Logo Markdown](/img/markdown.png)`
`![Logo](/img/markdown.png "Markdown")`
`[![Cliquable](/img/markdown.png)](https://markdown69.com)`

Code

Entourez le code en ligne de simples accents graves. Pour un bloc entier, utilisez trois accents graves (en nommant éventuellement le langage) ou indentez chaque ligne de quatre espaces.

Markdown	Résultat
Utilisez la fonction `print()`.	Utilisez la fonction `print()`.
``` bloc de code simple ```	`bloc de code simple`
```python def hello(): print("Hi!") ```	`def hello(): print("Hi!")`

Tableaux

Séparez les colonnes par des barres verticales | et l’en-tête du corps par des tirets -. Ajoutez des deux-points : dans la ligne de séparation pour aligner une colonne à gauche, au centre ou à droite.

Markdown Résultat

| Syntaxe | Description |
| ------ | ----------- |
| En-tête | Titre |
| Cellule | Texte |

Syntaxe	Description
En-tête	Titre
Cellule	Texte

| Gauche | Centre | Droite |
| :--- | :----: | ----: |
| a | b | c |

Gauche	Centre	Droite
a	b	c

Filet horizontal

Trois tirets, astérisques ou tirets bas ou plus, seuls sur leur ligne, tracent un séparateur.

Markdown	Résultat
`--- *** ___`

Sauts de ligne

Terminez une ligne par deux espaces pour la couper sans commencer un nouveau paragraphe. Une ligne vide commence toujours un nouveau paragraphe.

Markdown Résultat

Première ligne··
Deuxième ligne

Première ligne
Deuxième ligne

Nouveau paragraphe

après une ligne vide

Nouveau paragraphe

après une ligne vide

Échapper les caractères

Placez une barre oblique inverse \ devant un symbole pour l’afficher littéralement au lieu de mettre le texte en forme.

Markdown	Résultat
`\Pas en italique\`	Pas en italique
`1\. Pas une liste`	1. Pas une liste

Notes de bas de page

Marquez un endroit avec [^1] et écrivez la note n’importe où sur sa propre ligne. Le lecteur passe de l’une à l’autre en cliquant.

Markdown	Résultat
`Voici une note.[^1] [^1]: Le texte de la note.`	Voici une note.¹ Le texte de la note. ↩

Emoji

De nombreux éditeurs (GitHub, Slack, Discord) transforment les :shortcodes: en emoji. Vous pouvez aussi coller directement le caractère emoji.

Markdown	Résultat
`:tada: Livré ! :rocket:`	🎉 Livré ! 🚀
`Ça a l'air bien :+1:`	Ça a l'air bien 👍

HTML en ligne

Quand Markdown ne suffit pas, insérez du HTML brut et il s’affiche tel quel.

Markdown	Résultat
`Texte avec <sub>indice</sub> et <sup>exposant</sup>.`	Texte avec _indice et ^exposant.
`<kbd>Ctrl</kbd> + <kbd>C</kbd>`	`Ctrl` + `C`

Intégrer des vidéos

Markdown ne peut pas intégrer un lecteur vidéo, mais vous pouvez lier une image miniature à la vidéo. Cliquer sur l’image ouvre la vidéo.

Markdown	Résultat
`[![Regarder la vidéo](/img/markdown.png)](https://youtu.be/VIDEO_ID)`

Éditeur Markdown en ligne avec aperçu en direct