Ouvrez n'importe quel dossier où Claude Code a travaillé : il s'est rempli de fichiers .md. Un CLAUDE.md, un README.md, des notes, des plans. Vous ne les avez pas demandés dans ce format. Pourtant, ils arrivent comme ça. Ce format s'appelle le markdown : ça vaut la peine de le comprendre une fois pour toutes, c'est très court.
Un fichier markdown est un simple fichier texte : pas de logiciel propriétaire, pas de mise en forme cachée. Ce que vous voyez, c'est tout ce qu'il contient. Sa seule particularité, une poignée de conventions pour indiquer la structure (titre, gras, liste) avec des caractères du clavier : le fichier reste lisible tel quel, affichable joliment par tout logiciel qui connaît ces conventions.
Ce que contient le fichier
## Mes services
Je propose deux formules :
- **Essentiel** : un atelier
d'une demi-journée
- **Complet** : trois mois
d'accompagnement
Détails sur [mon site](https://exemple.ch).
Ce que ça donne une fois affiché
Mes services
Je propose deux formules :
- Essentiel : un atelier d'une demi-journée
- Complet : trois mois d'accompagnement
Détails sur mon site.
Tout le markdown que vous croiserez tient dans ce tableau :
| Élément | Ce que vous tapez | À savoir |
|---|---|---|
| Titre | # Mon titre |
Le dièse en début de ligne, suivi d'un espace |
| Sous-titre | ## Mon sous-titre |
Plus de dièses = niveau plus profond (###, ####...) |
| Gras | **important** |
Un seul astérisque de chaque côté = italique |
| Liste à puces | - élément |
Un tiret + espace en début de ligne, un élément par ligne |
| Liste numérotée | 1. élément |
La numérotation se recale toute seule à l'affichage |
| Lien | [texte](https://adresse.ch) |
Le texte entre crochets, l'adresse entre parenthèses |
| Image |  |
Comme un lien, précédé d'un point d'exclamation |
| Bloc de code | ``` |
Trois accents graves pour ouvrir, trois pour fermer |
Ces huit-là couvrent l'essentiel. Ce tableau lui-même est du markdown : des barres verticales | entre les colonnes, rien de plus.
Pourquoi ce format est-il partout avec l'IA ? Il est des deux côtés de la conversation. Claude répond dans le chat en markdown : c'est l'interface qui le met en forme. Dans un CLAUDE.md, la structure en titres aide Claude à distinguer vos consignes. Pour documenter un projet ou rédiger des notes, il choisit ce format spontanément : assez de structure, aucune lourdeur de mise en page.
Pas besoin d'écrire du markdown correct pour être compris : l'IA lit très bien le texte libre. Ces symboles servent d'abord à lire ce qu'elle produit et à structurer un CLAUDE.md proprement.
Dernier point : comment ouvrir un .md. N'importe quel éditeur de texte fait l'affaire, TextEdit sur Mac, le Bloc-notes sur Windows. Le double-clic ouvre parfois un logiciel inattendu ; un clic droit puis « Ouvrir avec » règle la question. Le plus simple : demander à Claude, dans le dossier concerné, « montre-moi ce que contient ce fichier et résume-le ».