Aide-mémoire Markdown : Guide de référence complet
· 12 min de lecture
Markdown est devenu le langage universel du formatage de texte sur le web. Que vous rédigiez de la documentation sur GitHub, postiez sur Reddit, discutiez sur Discord, organisiez des notes dans Notion ou créiez du contenu pour d'innombrables autres plateformes, Markdown est partout. Apprendre cette syntaxe simple mais puissante vous rendra plus productif dans tous les espaces de travail numériques que vous utilisez.
Ce guide complet couvre tout, du formatage de base aux techniques avancées, avec des exemples pratiques et des cas d'usage réels. Mettez cette page en favori comme référence incontournable pour tout ce qui concerne Markdown.
📑 Table des matières
- Qu'est-ce que Markdown et pourquoi l'utiliser ?
- Formatage de texte de base
- Titres et structure du document
- Listes : ordonnées, non ordonnées et imbriquées
- Liens et images
- Blocs de code et coloration syntaxique
- Création de tableaux
- Citations et références
- Fonctionnalités avancées de Markdown
- Variantes et extensions de Markdown
- Bonnes pratiques et erreurs courantes
- Questions fréquemment posées
Qu'est-ce que Markdown et pourquoi l'utiliser ?
Markdown est un langage de balisage léger créé par John Gruber en 2004. Sa philosophie est simple : le texte brut doit être lisible tel quel, mais aussi convertible en HTML et autres formats. Contrairement aux éditeurs de texte enrichi qui cachent le formatage derrière des boutons et des menus, Markdown garde tout visible et portable.
La beauté de Markdown réside dans sa simplicité. Vous pouvez l'écrire dans n'importe quel éditeur de texte, le versionner avec Git et le convertir en HTML, PDF ou des dizaines d'autres formats. Il est devenu la norme de facto pour la documentation technique, les fichiers README, les articles de blog et l'écriture collaborative.
Où Markdown est utilisé :
- GitHub, GitLab et Bitbucket pour les fichiers README et la documentation
- Reddit, Discord et Slack pour les messages formatés
- Notion, Obsidian et Roam Research pour la prise de notes
- Les générateurs de sites statiques comme Jekyll, Hugo et Gatsby
- Les systèmes de gestion de contenu et les plateformes de blog
- Les outils de rédaction technique et les plateformes de documentation
Conseil pro : Utilisez notre Éditeur Markdown gratuit pour pratiquer la syntaxe en temps réel avec aperçu en direct. C'est le moyen le plus rapide d'apprendre en pratiquant.
Formatage de texte de base
La syntaxe de formatage de base de Markdown est intuitive et facile à retenir. La plupart du formatage utilise des caractères spéciaux qui entourent le texte que vous souhaitez styliser.
Texte en gras
Créez du texte en gras en entourant les mots avec des doubles astérisques ou des doubles traits de soulignement :
**Ce texte est en gras**
__Ceci est aussi en gras__
Les deux produisent : Ce texte est en gras
Texte en italique
Utilisez des astérisques simples ou des traits de soulignement simples pour le texte en italique :
*Ce texte est en italique*
_Ceci est aussi en italique_
Les deux produisent : Ce texte est en italique
Gras et italique combinés
Combinez les deux en utilisant trois astérisques ou en mélangeant astérisques et traits de soulignement :
***Texte en gras et italique***
**_Aussi en gras et italique_**
Résultat : Texte en gras et italique
Texte barré
La plupart des variantes de Markdown prennent en charge le texte barré avec des doubles tildes :
~~Ce texte est barré~~
Résultat : Ce texte est barré
Code en ligne
Entourez le texte avec des accents graves simples pour le formater comme du code en ligne :
Utilisez la fonction `console.log()` pour déboguer.
Résultat : Utilisez la fonction console.log() pour déboguer.
| Syntaxe | Résultat | Cas d'usage |
|---|---|---|
**texte** |
texte | Emphase, termes importants |
*texte* |
texte | Emphase subtile, titres de livres |
~~texte~~ |
Contenu supprimé, corrections | |
`texte` |
texte |
Code, commandes, noms de fichiers |
Titres et structure du document
Les titres créent une hiérarchie de document et améliorent la lisibilité. Markdown prend en charge six niveaux de titres, correspondant aux balises <h1> à <h6> de HTML.
# Titre 1 (Le plus grand)
## Titre 2
### Titre 3
#### Titre 4
##### Titre 5
###### Titre 6 (Le plus petit)
Le nombre de symboles dièse détermine le niveau du titre. Incluez toujours un espace entre les symboles dièse et le texte du titre.
Bonne pratique : Utilisez les niveaux de titre de manière hiérarchique. Ne sautez pas de H1 à H4. Cela améliore l'accessibilité pour les lecteurs d'écran et aide les moteurs de recherche à comprendre la structure de votre contenu.
Syntaxe alternative pour les titres
Pour H1 et H2, vous pouvez également utiliser la syntaxe de soulignement :
Titre 1
=========
Titre 2
---------
Cependant, la syntaxe avec symbole dièse est plus courante et prend en charge les six niveaux.
Bonnes pratiques pour les titres
- Utilisez un seul H1 par document (généralement le titre)
- Gardez les titres concis et descriptifs
- Utilisez la casse de phrase ou la casse de titre de manière cohérente
- Ne terminez pas les titres par de la ponctuation
- Ajoutez des lignes vides avant et après les titres pour la lisibilité
Listes : ordonnées, non ordonnées et imbriquées
Les listes sont fondamentales pour organiser l'information. Markdown prend en charge les listes non ordonnées (à puces), les listes ordonnées (numérotées) et les combinaisons imbriquées des deux.
Listes non ordonnées
Créez des listes à puces en utilisant des astérisques, des tirets ou des signes plus. Les trois produisent un résultat identique :
* Premier élément
* Deuxième élément
* Troisième élément
- Premier élément
- Deuxième élément
- Troisième élément
+ Premier élément
+ Deuxième élément
+ Troisième élément
Choisissez un style et respectez-le tout au long de votre document pour la cohérence.
Listes ordonnées
Numérotez vos éléments de liste avec des points. Les nombres réels n'ont pas d'importance—Markdown les renumérotera automatiquement :
1. Premier élément
2. Deuxième élément
3. Troisième élément
1. Premier élément
1. Deuxième élément
1. Troisième élément
Les deux produisent la même liste numérotée. Utiliser tous des 1 facilite la réorganisation des éléments sans renumérotation.
Listes imbriquées
Indentez les éléments imbriqués avec 2 ou 4 espaces (soyez cohérent) :
1. Premier élément
- Puce imbriquée
- Autre puce imbriquée
2. Deuxième élément
1. Numéro imbriqué
2. Autre numéro imbriqué
Listes de tâches
De nombreuses variantes de Markdown prennent en charge les listes de tâches avec des cases à cocher :
- [x] Tâche terminée
- [ ] Tâche incomplète
- [ ] Autre tâche incomplète
Ceci est particulièrement utile dans les problèmes GitHub et les outils de gestion de projet.
Astuce rapide : Lors de l'écriture d'éléments de liste à plusieurs paragraphes, indentez les paragraphes suivants pour les aligner avec la première ligne de texte, pas avec la puce.
Liens et images
Markdown facilite l'ajout d'hyperliens et d'images sans encombrer votre texte avec des balises HTML.
Liens de base
La syntaxe pour les liens est simple : crochets pour le texte du lien, suivis de parenthèses pour l'URL :
[Visitez notre Éditeur Markdown](/tools/markdown-editor/)
Résultat : Visitez notre Éditeur Markdown
Liens avec titres
Ajoutez un attribut de titre (affiché au survol) en l'incluant entre guillemets après l'URL :
[GitHub](https://github.com "Visiter GitHub")
Liens de style référence
Pour les documents avec de nombreux liens répétés, utilisez la syntaxe de style référence pour garder votre texte propre :
Consultez [Google][1] et [GitHub][2] pour plus d'informations.
[1]: https://google.com "Google"
[2]: https://github.com "GitHub"
Les définitions de référence peuvent apparaître n'importe où dans le document et ne seront pas visibles dans le résultat.
Liens automatiques
Entourez les URL ou adresses e-mail de chevrons pour les rendre cliquables :
<https://example.com>
<email@example.com>
De nombreux processeurs Markdown créent également automatiquement des liens pour les URL nues sans chevrons.
Images
La syntaxe des images est identique aux liens, mais avec un point d'exclamation en préfixe :


Le texte alternatif est crucial pour l'accessibilité et le référencement. Fournissez toujours un texte alternatif descriptif qui explique ce que montre l'image.
Bonnes pratiques pour les images
- Rédigez un texte alternatif descriptif pour l'accessibilité
- Utilisez des chemins relatifs pour les images dans le même dépôt
- Optimisez les tailles de fichiers d'image pour un chargement plus rapide
- Envisagez d'utiliser la syntaxe de style référence pour les images répétées
- Testez que les images s'affichent correctement sur votre plateforme cible
Blocs de code et coloration syntaxique
Les blocs de code sont essentiels pour la documentation technique. Markdown fournit plusieurs façons de formater le code, des extraits en ligne aux blocs multi-lignes avec coloration syntaxique.
Code en ligne
Comme mentionné précédemment, entourez le code en ligne avec des accents graves simples :
Utilisez la commande `git commit` pour enregistrer les modifications.
Blocs de code délimités
Pour le code multi-lignes, utilisez des triples accents graves (ou triples tildes) avant et après le code :
```
function greet(name) {
return `Hello, ${name}!`;
}
```
Coloration syntaxique
Spécifiez le langage de programmation après les accents graves d'ouverture pour la coloration syntaxique :
```javascript
function greet(name) {
return `Hello, ${name}!`;
}
```
```python
def greet(name):
return f"Hello, {name}!"
```
```css
.button {
background-color: #06b6d4;
border-radius: 8px;
}
```
La plupart des processeurs Markdown prennent en charge des dizaines de langages, notamment JavaScript, Python, Java, C++, Ruby, Go, Rust, SQL, HTML, CSS et bien d'autres.
Blocs de code indentés
Une syntaxe plus ancienne utilise une indentation de 4 espaces pour créer des blocs de code :
function example() {
return true;
}
Cependant, les blocs de code délimités sont préférés car ils prennent en charge la coloration syntaxique et sont plus faciles à lire en texte brut.
Conseil pro : Utilisez notre Embellisseur HTML pour formater le code avant de le coller dans des documents Markdown. Un code propre et bien formaté est plus facile à lire et à maintenir.
Création de tableaux
Les tableaux organisent les données en lignes et colonnes. Bien que les tableaux Markdown ne soient pas aussi flexibles que les tableaux HTML, ils sont parfaits pour la présentation de données simples.
Syntaxe de tableau de base
Créez des tableaux en utilisant des barres verticales et des tirets :
| En-tĂŞte 1 | En-tĂŞte 2 | En-tĂŞte 3 |
|-----------|-----------|-----------|
| Cellule 1 | Cellule 2 | Cellule 3 |
| Cellule 4 | Cellule 5 | Cellule 6 |
Les barres verticales n'ont pas besoin d'être parfaitement alignées—les processeurs Markdown les formateront correctement. Cependant, les barres alignées rendent les tableaux plus faciles à lire en texte brut.
Alignement des colonnes
Contrôlez l'alignement du texte en utilisant des deux-points dans la ligne de séparation :
| Aligné à gauche | Centré | Aligné à droite |
|:----------------|:------:|----------------:|
| Texte | Texte | Texte |
| Plus de texte | Plus | Plus de texte |
:---aligne à gauche (par défaut):---:centre le texte---:aligne à droite
Exemple de tableau pratique
| Variante Markdown | Tableaux | Listes de tâches | Notes de bas de page |
|---|---|---|---|
| CommonMark | ❌ Non | ❌ Non |