Qu'est-ce que le Markdown ?

Le Markdown est un langage de balisage léger qui permet de mettre en forme du texte brut — titres, listes, liens, emphase — avec des symboles simples et lisibles. Il est très utilisé pour les README, la documentation et les notes.

Comment écrire un bloc de code en Markdown ?

Encadrez le code par trois accents graves (```) sur leurs propres lignes, en ajoutant éventuellement un nom de langage après la clôture d'ouverture pour la coloration syntaxique.

Le Markdown fonctionne-t-il pareil partout ?

La syntaxe de base est cohérente, mais les variantes diffèrent. Le GitHub Flavored Markdown ajoute tableaux, listes de tâches et texte barré au Markdown standard.

AIDE-MÉMOIRE

Guide Markdown

Tout ce qu'il faut savoir pour écrire en Markdown : chaque élément de syntaxe est présenté avec sa source à gauche et son rendu à droite.

Titres

Six niveaux de titres, du plus grand au plus petit, avec le caractère #.

Markdown

# Titre 1
## Titre 2
### Titre 3
#### Titre 4
##### Titre 5
###### Titre 6

Résultat

Titre 1

Titre 2

Titre 3

Titre 4

Titre 5

Titre 6

Markdown

Titre 1 (syntaxe alternative)
===

Titre 2 (syntaxe alternative)
---

Résultat

Titre 1 (syntaxe alternative)

Titre 2 (syntaxe alternative)

Paragraphes

Séparez les paragraphes par une ligne vide et forcez un saut de ligne au besoin.

Markdown

Un paragraphe est un bloc de texte.

Une ligne vide sépare deux paragraphes.

Résultat

Un paragraphe est un bloc de texte.

Une ligne vide sépare deux paragraphes.

Markdown

Terminez une ligne par deux espaces␣␣
pour forcer un saut de ligne.

Ou utilisez une barre oblique inverse\
en fin de ligne.

Résultat

Terminez une ligne par deux espaces
pour forcer un saut de ligne.

Ou utilisez une barre oblique inverse
en fin de ligne.

Emphase

Mettez du texte en gras, en italique ou barré.

Markdown

*italique* ou _italique_
**gras** ou __gras__
***gras et italique***
~~barré~~

Résultat

italique ou italique
gras ou gras
gras et italique
~~barré~~

Citations

Citez du texte, sur une ou plusieurs lignes, et imbriquez les citations.

Markdown

> Une citation simple.
>
> Sur plusieurs lignes.

Résultat

Une citation simple.
Sur plusieurs lignes.

Markdown

> Citation
>> Citation imbriquée
>>> Encore plus profond

Résultat

Citation
Citation imbriquée
Encore plus profond

Listes

Listes à puces, numérotées, imbriquées et listes de tâches.

Markdown

- Premier élément
- Deuxième élément
- Troisième élément

* Fonctionne aussi avec *
+ ou avec +

Résultat

Premier élément
Deuxième élément
Troisième élément

Fonctionne aussi avec *
ou avec +

Markdown

1. Premier
2. Deuxième
3. Troisième

Résultat

Premier
Deuxième
Troisième

Markdown

- Élément parent
  - Sous-élément
    - Sous-sous-élément
- Retour au parent

Résultat

Élément parent
- Sous-élément
  - Sous-sous-élément
Retour au parent

Markdown

- [x] Tâche terminée
- [ ] Tâche à faire
- [ ] Autre tâche

Résultat

Tâche terminée
Tâche à faire
Autre tâche

Code

Code en ligne, blocs de code et coloration syntaxique par langage.

Markdown

Utilisez `code en ligne` dans une phrase.

Résultat

Utilisez code en ligne dans une phrase.

Markdown

```
Bloc de code sans coloration
sur plusieurs lignes
```

Résultat

Bloc de code sans coloration
sur plusieurs lignes

Markdown

```js
function salut(nom) {
  return `Bonjour ${nom}`;
}
```

Résultat

function salut(nom) {
  return `Bonjour ${nom}`;
}

Liens

Liens simples, avec infobulle, automatiques ou par référence.

Markdown

[Texte du lien](https://exemple.com)
[Avec une infobulle](https://exemple.com "Titre au survol")

Résultat

Texte du lien
Avec une infobulle

Markdown

Lien automatique : <https://exemple.com>

Lien de référence : [le texte][1]

[1]: https://exemple.com

Résultat

Lien automatique : https://exemple.com

Lien de référence : le texte

Images

Insérez des images, avec texte alternatif, titre ou lien cliquable.

Markdown

![Texte alternatif](image.png)
![Avec titre](image.png "Titre au survol")

Résultat

Markdown

Une image cliquable :

[![Alt](image.png)](https://exemple.com)

Résultat

Une image cliquable :

Tableaux

Créez des tableaux et alignez les colonnes à gauche, au centre ou à droite.

Markdown

| Nom   | Rôle      | Score |
| ----- | --------- | ----- |
| Alice | Admin     | 95    |
| Bob   | Éditeur   | 82    |

Résultat

Nom	Rôle	Score
Alice	Admin	95
Bob	Éditeur	82

Markdown

| Gauche | Centré | Droite |
| :----- | :----: | -----: |
| a      |   b    |      c |
| dd     |   ee   |     ff |

Résultat

Gauche	Centré	Droite
a	b	c
dd	ee	ff

Lignes horizontales

Séparez des sections avec une ligne horizontale.

Markdown

Trois tirets, astérisques ou underscores :

---

***

___

Résultat

Trois tirets, astérisques ou underscores :

Échappement

Affichez des caractères spéciaux sans qu'ils soient interprétés.

Markdown

\*Ceci n'est pas en italique\*
\# Ceci n'est pas un titre
\[Ceci n'est pas un lien\]

Résultat

*Ceci n'est pas en italique*
# Ceci n'est pas un titre
[Ceci n'est pas un lien]

Markdown étendu

Notes de bas de page, émoji et HTML intégré (selon le moteur).

Markdown

Voici une note de bas de page.[^1]

[^1]: Le contenu de la note.

Résultat

Voici une note de bas de page.¹

Le contenu de la note. ↩

Markdown

Émoji par code : :tada: :rocket: :+1:

Émoji direct : 🎉 🚀 👍

Résultat

Émoji par code : 🎉 🚀 👍

Émoji direct : 🎉 🚀 👍

Markdown

On peut aussi insérer du <mark>HTML</mark>
directement : <kbd>Ctrl</kbd> + <kbd>C</kbd>.

Résultat

On peut aussi insérer du HTML directement : Ctrl + C.

Le Markdown est un standard, mais certains éléments (tableaux, cases à cocher, notes de bas de page, émoji) dépendent du moteur de rendu utilisé.

À propos de ce guide Markdown

Une antisèche Markdown claire et illustrée couvrant la syntaxe du quotidien : titres, gras et italique, listes, liens, images, tableaux, blocs de code, citations et plus. Chaque exemple montre la source Markdown à côté de son rendu.

FAQ

Qu'est-ce que le Markdown ?: Le Markdown est un langage de balisage léger qui permet de mettre en forme du texte brut — titres, listes, liens, emphase — avec des symboles simples et lisibles. Il est très utilisé pour les README, la documentation et les notes.
Comment écrire un bloc de code en Markdown ?: Encadrez le code par trois accents graves (```) sur leurs propres lignes, en ajoutant éventuellement un nom de langage après la clôture d'ouverture pour la coloration syntaxique.
Le Markdown fonctionne-t-il pareil partout ?: La syntaxe de base est cohérente, mais les variantes diffèrent. Le GitHub Flavored Markdown ajoute tableaux, listes de tâches et texte barré au Markdown standard.