Vous avez probablement déjà utilisé le Markdown sans le savoir. Quand vous mettez un mot entre astérisques sur WhatsApp pour le mettre en gras, quand vous écrivez un README sur GitHub, ou quand vous prenez des notes dans Notion ou Obsidian — c'est du Markdown. Ce langage simple, inventé en 2004, est devenu le standard de fait pour écrire du texte structuré sur le web.
Pourquoi le Markdown existe
Le problème du texte enrichi
Vous connaissez le dilemme : le texte brut (.txt) est universel mais ne permet aucune mise en forme. Les formats riches (Word, PDF) permettent une mise en forme sophistiquée mais sont lourds, propriétaires et peu adaptés au web. Le HTML permet tout, mais écrire <strong>texte en gras</strong> pour chaque mot est fastidieux.
Le Markdown résout ce problème : c'est un langage de balisage lisible par un humain même sous sa forme brute, et convertible automatiquement en HTML, PDF, ou tout autre format.
La philosophie
John Gruber, le créateur du Markdown, avait un principe simple : le texte source doit être aussi lisible que le résultat final. Un document Markdown brut se lit facilement, contrairement au HTML ou au LaTeX.
Le saviez-vous ? Le nom « Markdown » est un jeu de mots avec « Markup » (langage de balisage). C'est un balisage simplifié, d'où le jeu sur « mark-down » (simplifier) au lieu de « mark-up » (baliser).
La syntaxe essentielle en 5 minutes
Les titres
Les titres se créent avec le symbole #. Plus il y a de dièses, plus le niveau du titre est bas :
# Titre principal
## Sous-titre
### Sous-sous-titre
Le texte en gras et en italique
**texte en gras**
*texte en italique*
***gras et italique***
Les listes
Listes à puces avec -, * ou + :
- Premier élément
- Deuxième élément
- Troisième élément
Listes numérotées :
1. Première étape
2. Deuxième étape
3. Troisième étape
Les liens
[texte du lien](https://example.com)
Les images
Les citations
> Ceci est une citation.
> Elle peut tenir sur plusieurs lignes.
Le code
Code en ligne avec des accents graves :
Utilisez la fonction `print()` pour afficher du texte.
Bloc de code avec triple accent grave :
```python
def bonjour():
print("Bonjour le monde")
```
Les tableaux
| Colonne 1 | Colonne 2 |
|-----------|-----------|
| Cellule 1 | Cellule 2 |
| Cellule 3 | Cellule 4 |
Astuce Vous n'avez pas besoin de mémoriser toute la syntaxe d'un coup. Commencez par les titres, le gras et les listes — c'est ce que vous utiliserez 80 % du temps. Le reste viendra naturellement.
Où utiliser le Markdown
Au quotidien
- GitHub / GitLab : fichiers README, issues, pull requests, commentaires
- Notion, Obsidian, Bear : prise de notes
- Discord, Slack, Teams : mise en forme des messages
- Reddit : rédaction de posts et commentaires
- Stack Overflow : questions et réponses
Pour les développeurs
- Documentation technique
- Fichiers README de projets
- Blogs statiques (Hugo, Jekyll, Astro, Next.js)
- Wikis internes
Pour les rédacteurs
- Articles de blog
- Documentation produit
- Newsletters
- E-books et publications numériques
Les avantages du Markdown
| Critère | Markdown | Word / Google Docs |
|---|---|---|
| Portabilité | Fichier texte universel | Format propriétaire |
| Taille du fichier | Quelques Ko | Souvent des Mo |
| Contrôle de version (Git) | Parfait | Difficile |
| Conversion vers d'autres formats | Facile | Limité |
| Lisibilité du source | Excellente | N/A (format binaire) |
| Courbe d'apprentissage | 5 minutes | Variable |
La portabilité
Un fichier Markdown est un simple fichier texte avec l'extension .md. Il s'ouvre avec n'importe quel éditeur de texte, sur n'importe quel système d'exploitation. Pas de format propriétaire, pas de version incompatible, pas de logiciel requis.
Le contrôle de version
Pour les développeurs, c'est un avantage majeur. Un fichier Markdown peut être versionné avec Git comme n'importe quel code source. Les modifications sont visibles ligne par ligne dans un diff, contrairement à un fichier Word où les changements sont opaques.
Attention Il existe plusieurs « saveurs » de Markdown (CommonMark, GitHub Flavored Markdown, MultiMarkdown). La syntaxe de base est identique partout, mais les extensions (tableaux, notes de bas de page, diagrammes) varient selon les plateformes. Vérifiez ce que supporte votre outil.
Tester et pratiquer
La meilleure façon d'apprendre le Markdown est de l'écrire. Un éditeur Markdown avec prévisualisation en temps réel vous montre immédiatement le résultat de votre syntaxe.
Pour commencer à pratiquer : Écrire en Markdown.
Le saviez-vous ? Cet article que vous lisez a été rédigé en Markdown. La plupart des sites web modernes utilisent le Markdown comme format source pour leur contenu, qui est ensuite converti automatiquement en HTML pour l'affichage.
En résumé
Le Markdown est le couteau suisse de l'écriture numérique. Avec une poignée de symboles simples (#, **, -, []()) vous pouvez structurer n'importe quel texte de manière claire et portable. La courbe d'apprentissage est quasi nulle, et une fois adopté, vous ne voudrez plus revenir en arrière.
Commencez par écrire votre premier document en Markdown et voyez comme c'est naturel.