Le guide complet de Markdown - Des bases aux fonctionnalités avancées

Introduction : Qu'est-ce que Markdown ?

Markdown est un langage de balisage léger créé par John Gruber en 2004. Son objectif principal est d'être aussi lisible que possible dans sa forme brute, tout en étant convertible en HTML valide. Aujourd'hui, Markdown est devenu le standard de facto pour écrire du contenu sur le web — des documentations et fichiers README aux articles de blog, commentaires et plateformes de messagerie.

Vous voulez pratiquer en lisant ce guide ? Essayez notre outil Aperçu Markdown pour voir votre Markdown rendu en temps réel.

Pourquoi utiliser Markdown ?

• Lisibilité : Le Markdown brut est facile à lire, même sans rendu
• Portabilité : Les fichiers Markdown sont du texte brut et fonctionnent partout
• Simplicité : La syntaxe est intuitive et facile à apprendre
• Large support : Utilisé par GitHub, GitLab, Reddit, Stack Overflow, Notion, Obsidian et bien plus
• Compatible avec le contrôle de version : Étant du texte brut, Markdown fonctionne parfaitement avec Git
• Convertible : Markdown peut être converti en HTML, PDF, DOCX et de nombreux autres formats
• Focus sur le contenu : Markdown vous permet de vous concentrer sur l'écriture plutôt que sur la mise en forme

Syntaxe de base

Titres

Les titres sont créés en ajoutant un à six symboles # avant le texte du titre :

# Titre 1 (H1)
## Titre 2 (H2)
### Titre 3 (H3)
#### Titre 4 (H4)
##### Titre 5 (H5)
###### Titre 6 (H6)

Bonnes pratiques pour les titres :

• Toujours mettre un espace entre # et le texte du titre
• Utiliser un seul H1 par document (généralement le titre)
• Ne pas sauter de niveaux de titre (passer de H2 à H3, pas de H2 à H4)
• Garder les titres concis et descriptifs

Emphase (Gras et Italique)

*texte en italique* ou _texte en italique_

**texte en gras** ou __texte en gras__

***gras et italique*** ou ___gras et italique___

~~texte barré~~

Citations

> Ceci est une citation.
>
> Elle peut s'étendre sur plusieurs paragraphes.

> Les citations peuvent être imbriquées.
>
>> Ceci est une citation imbriquée.

Listes

Listes non ordonnées avec -, * ou + :

- Élément 1
- Élément 2
  - Sous-élément 2.1
  - Sous-élément 2.2
- Élément 3

Listes ordonnées avec des chiffres suivis de points :

1. Premier élément
2. Deuxième élément
3. Troisième élément

Liens et images

Liens

[Texte du lien](https://example.com)

[Lien avec titre](https://example.com "Titre du lien")

<https://example.com> (lien automatique)

Images

![Texte alternatif](url-image.png)

![Texte alternatif](url-image.png "Titre de l'image")

Code

Code en ligne

Entourer le code en ligne avec des guillemets simples :

Utilisez la fonction `console.log()` pour déboguer.

Blocs de code

Utilisez des triple guillemets avec un identificateur de langage optionnel pour la coloration syntaxique :

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}
```

```python
def greet(name):
    return f"Hello, {name}!"
```

Tableaux

Les tableaux sont créés avec des barres verticales (|) et des tirets (-) :

| Fonctionnalité | Plan gratuit | Plan Pro | Entreprise |
|----------------|-------------|---------|-----------|
| Utilisateurs | 1 | 10 | Illimité |
| Stockage | 1 Go | 100 Go | 1 To |
| Support | Communauté | Email | Téléphone 24/7 |

Résultat rendu :

Fonctionnalité	Plan gratuit	Plan Pro	Entreprise
Utilisateurs	1	10	Illimité
Stockage	1 Go	100 Go	1 To
Support	Communauté	Email	Téléphone 24/7

GitHub Flavored Markdown (GFM)

Listes de tâches

- [x] Configuration du projet terminée
- [x] Documentation rédigée
- [ ] Ajouter des tests unitaires
- [ ] Déployer en production

Résultat rendu :

• Configuration du projet terminée
• Documentation rédigée
• Ajouter des tests unitaires
• Déployer en production

Emoji

GFM supporte les codes courts emoji :

:smile: :rocket: :bug: :white_check_mark: :warning:

Notes de bas de page

Cette affirmation a besoin d'une source[^1].

[^1]: Source : Journal of Computer Science, 2026.

Alertes GitHub

> [!NOTE]
> Informations utiles que les utilisateurs devraient connaître.

> [!WARNING]
> Informations urgentes nécessitant une attention immédiate.

Bonnes pratiques Markdown

1. Commencer par un seul H1 : C'est généralement le titre du document
2. Utiliser les titres de façon hiérarchique : H2 pour les sections principales, H3 pour les sous-sections
3. Garder les paragraphes courts : Viser 3-5 phrases par paragraphe
4. Toujours spécifier le langage : Utiliser des blocs de code avec identifiants de langage
5. Utiliser du texte de lien descriptif : Éviter « cliquez ici », utilisez du texte significatif

Référence rapide Markdown

Élément	Syntaxe	Notes
Titre	# H1 à ###### H6	Espace après #
Gras	**texte**	Ou __texte__
Italique	*texte*	Ou _texte_
Barré	~~texte~~	Fonctionnalité GFM
Citation	> texte	Imbriquable
Liste ordonnée	1. élément	Numéros auto-incrémentés
Liste non ordonnée	- élément	Aussi * ou +
Code en ligne	`code`	Guillemets simples
Bloc de code	```	Triple guillemets
Lien	[texte](url)	Titre optionnel
Image		Titre optionnel
Ligne horizontale	---	Aussi *** ou ___
Tableau	| col | col |	Fonctionnalité GFM
Liste de tâches	- [x] fait	Fonctionnalité GFM
Note de bas de page	texte[^1]	Pas universel

Conclusion

Markdown est un outil puissant et simple que tout développeur et rédacteur technique devrait connaître. Son format texte brut le rend parfait pour la documentation sous contrôle de version, les articles de blog, les fichiers README et bien plus encore.

Pour pratiquer l'écriture Markdown et voir votre travail rendu instantanément, essayez notre outil gratuit Aperçu Markdown.

Ressources associées

• Outil d'aperçu Markdown — Prévisualiser votre Markdown en temps réel
• Compteur de mots — Compter les mots dans vos documents Markdown
• Formateur JSON — Formater le JSON pour les exemples de code
• Guide des regex pour débutants — Apprendre le regex pour le traitement de texte