Le format que toutes les IA ont choisi : le Markdown (.md) expliqué simplement

Pour bien comprendre, il faut remonter à l'origine. J'ai retrouvé le blog du créateur, John Gruber. Sa définition tient en une phrase : « Markdown is a text to HTML conversion for web writers ». En clair, il a créé une syntaxe pour afficher des choses sur le web, des titres, du texte, sans écrire de HTML. Et son but de départ, c'était d'afficher des articles de blog. Aujourd'hui, la plupart des blogs et des tutos sont écrits comme ça.

Il n'y a rien de compliqué. C'est un fichier texte, comme celui que tu ouvrirais dans un bloc-notes, sauf qu'on a un rendu un peu plus précis. Tu rajoutes un dièse devant un texte et ça devient un titre. L'équivalent en HTML, c'est la balise H1. Deux dièses, c'est un sous-titre. Des tirets, c'est une liste. C'est vraiment de la mise en forme, pas du code.

Je te montre comment faire en deux minutes. Dans ton éditeur de code, tu crées un fichier que tu nommes test.md. L'extension .md est importante, c'est elle qui dit qu'on veut le rendu Markdown. Je tape une phrase, par exemple « Agent Skills for use with Obsidian », puis je clique sur le petit bouton de prévisualisation pour afficher le rendu réel.

Pour bien voir comment ça marche, je splitte mon écran en deux. À gauche mon texte brut, à droite le rendu. Si je rajoute un dièse devant mon titre, je vois tout de suite qu'il est joliment formaté. C'est facile à apprendre parce qu'au final tu tapes juste du texte.

Quand les IA ont récupéré tous les projets qui existaient sur le web, elles sont parties sur GitHub, l'endroit où le code est partagé. Pour savoir rapidement de quoi parlait un projet, elles ont lu son fichier README.md, qui est le mode d'emploi du projet. Tu ouvres n'importe quel dépôt, par exemple celui de React Native, et tu trouves à la racine ce fichier qui explique ce que fait la librairie, comment l'installer, comment l'utiliser. Du pain béni pour les IA.

On a repris à peu près la même nomenclature que le README, sauf qu'on l'a appelé CLAUDE.md. Dans la doc de Claude, il est fortement conseillé d'en avoir un à la racine. Le README.md reste la base d'un projet, mais le CLAUDE.md s'axe sur les guidelines : comment l'IA doit utiliser le projet, ce qu'elle doit faire si elle code dessus. Il reste minimal, avec moins d'informations que le README.

Le résultat est pratique. Quand je lance Claude dans un projet où un développeur a bien fait son boulot, l'IA récupère les bonnes pratiques et sait comment modifier le dépôt en les respectant. Tout le cadre tient dans un simple fichier texte.

Un skill, c'est une série d'instructions que tu redonnes à l'IA pour rejouer un scénario. Exemple : je demande à l'IA de créer une page qui affiche le profil d'un utilisateur. Demain, je vais vouloir la même chose. Plutôt que de tout réexpliquer, je crée un skill qui reprend mes instructions complètes, et j'aurai juste à le rappeler. Et ce skill, lui aussi, est écrit en Markdown. Je le relis vite, l'IA le relit vite.

C'est vraiment devenu le moyen de communication entre un humain et une IA. Je te conseille donc de bien comprendre comment organiser ton fichier Markdown et de respecter la convention : mettre des titres, mettre les éléments importants en gras, mettre des liens si besoin. Plus ton fichier est propre, plus ton IA utilise bien les données qu'il contient et plus elle devient pertinente.

Voilà pourquoi tu vois ce point MD partout. Ce n'est pas du code, c'est juste du texte, et c'est devenu doublement utile : pour documenter tes projets et pour alimenter ton IA. Tu peux lancer une instruction juste en tapant du Markdown. Si tu débutes avec l'IA, c'est le premier réflexe à prendre.