Markdown

Comment ça marche

Markdown est une façon d’écrire un document structuré avec de simples signes dans le texte. Un dièse devant une ligne en fait un titre, deux dièses un sous-titre. Un tiret en début de ligne fait une liste. Deux astérisques autour d’un mot le mettent en gras. Un fichier Markdown reste un fichier texte lisible tel quel, et n’importe quel outil compatible l’affiche mis en forme.

Pour l’IA, c’est le format maternel. Les modèles le lisent sans ambiguïté : un titre est un titre, une liste est une liste, ce qu’un document Word ne garantit pas une fois converti. Ils le produisent spontanément. Les fichiers de consignes des agents, les skills, les README des projets sont en Markdown. Et les schémas Mermaid s’y insèrent directement. Écrire en Markdown, c’est parler à l’IA dans sa langue.

Un exemple concret

# Compte rendu : réunion de lancement

**Date :** 21 octobre 2026
**Participants :** Claire, Thomas, Mme Durand (client)

## Décisions
- Livraison du prototype le 15 novembre
- Hébergement en Europe, confirmé

## Actions
- [ ] Envoyer le devis révisé (Thomas, 24 octobre)
- [ ] Préparer la liste des documents (Mme Durand, 28 octobre)

## Points ouverts
- Format des exports : à préciser avec l’équipe informatique

Ce que ça change pour une équipe

• Les documents de travail deviennent lisibles par l’IA. Procédures, gabarits, notes : en Markdown, un agent les lit sans rien perdre de leur structure.
• La mise en forme ne se discute plus. Pas de police, pas de couleur, pas de tabulation qui saute. Le contenu et sa structure, c’est tout.
• Tout se versionne. Un fichier texte se compare ligne à ligne. On voit ce qui a changé entre deux versions, ce qu’un Word ne permet pas simplement.
• Les outils se rejoignent. Le même fichier s’ouvre dans l’éditeur, dans l’outil de notes, dans l’agent, sur GitHub. Un format, partout.

Les limites et les erreurs fréquentes

• Vouloir une mise en page fine. Markdown structure, il ne met pas en page. Pour un document commercial soigné, on exporte vers un outil de mise en page.
• Mélanger les conventions. Les tableaux et quelques détails varient selon les outils. Tester dans l’outil où le document vivra.
• Oublier la hiérarchie. Un document avec des titres de niveau 1 partout, ou aucun, perd l’intérêt du format. Un titre, des sous-titres, des listes.
• Coller du Markdown brut dans un e-mail. Les dièses et les astérisques apparaissent tels quels. On convertit, ou on demande à l’assistant un texte sans mise en forme.