C’est quoi un fichier .md et comment l’utiliser avec une IA ?

Vous avez déjà expliqué à votre IA que vous ne voulez pas d’anecdotes inventées. Ni d’une introduction sur « un monde en constante évolution ». Elle corrige son article. Au travail suivant, vous lui redonnez les mêmes consignes, en vous demandant où la première explication est passée.

Une conversation permet de régler une tâche. Pour retrouver vos exigences d’un travail à l’autre, il faut aussi les conserver dans un endroit identifiable. Un fichier .md peut remplir cette fonction : vous y écrivez vos règles, vous les relisez et vous les transmettez à l’agent lorsqu’il en a besoin.

Le format est simple. La difficulté commence quand il faut décider ce que l’on veut conserver : une préférence de style, une règle de vérification ou une correction qui ne concernait qu’un seul texte. Le fichier oblige à rendre ces attentes lisibles, y compris pour soi.

C’est quoi un fichier .md ?

Un fichier .md est généralement un fichier texte écrit en Markdown, un langage de balisage léger : quelques signes de ponctuation indiquent les titres, le gras, les listes et les liens. On peut y écrire un article, une recette, une liste de tâches ou les consignes d’un projet. Le fichier reste lisible dans un simple éditeur de texte.

John Gruber a conçu Markdown pour que l’écriture et la lecture du document brut restent faciles, avant même sa conversion en page mise en forme. C’est ce principe qui explique son intérêt : vous pouvez comprendre le contenu sans disposer du logiciel qui en affiche une belle version. Présentation originale de Markdown.

Comment fonctionne Markdown ?

On écrit le contenu et les signes qui en indiquent la structure dans le même document. Voici quelques lignes en Markdown :

# Préparer un article

## Le sujet

Expliquer comment travailler avec une **IA** sans lui déléguer son jugement.

- Partir d’une situation concrète.
- Vérifier les références.
- Faire relire le texte avant publication.

[Une ressource sur Markdown](https://daringfireball.net/projects/markdown/)

Le signe #, suivi d’un espace, annonce le titre principal. Deux signes ## indiquent un sous-titre. Les doubles astérisques entourent du gras ; les tirets commencent une liste. Pour un lien, le texte visible se place entre crochets et l’adresse entre parenthèses. Une ligne vide sépare les paragraphes. Ces quelques conventions suffisent déjà à écrire des documents utiles. Syntaxe expliquée par GitHub.

Dans un éditeur ordinaire, vous voyez les signes. Dans une application qui interprète Markdown, vous voyez des titres, du gras et des liens cliquables. Le contenu est le même ; son affichage change. L’extension .md indique le format attendu. Elle ne transforme pas, à elle seule, ce que vous avez écrit.

Comment ouvrir et lire un fichier .md ?

Pour ouvrir un fichier .md, faites un clic droit sur le fichier, choisissez « Ouvrir avec », puis sélectionnez un éditeur de texte. Sous Windows, le Bloc-notes permet de lire son contenu et de le modifier. Si vous voyez des dièses et des astérisques, le fichier s’est bien ouvert : vous regardez le texte source.

Pour voir les titres et les listes mis en forme, utilisez un éditeur avec un aperçu Markdown. Dans Visual Studio Code, par exemple, ouvrez le fichier puis utilisez Ctrl + Maj + V sous Windows ou Cmd + Maj + V sur Mac. Vous pouvez ainsi passer du texte à son aperçu sans modifier le contenu. Lire du Markdown dans Visual Studio Code.

Ce choix dépend de ce que vous voulez faire. Pour corriger une consigne, le texte brut suffit. Pour relire un long article, l’aperçu rend sa structure plus visible. Dans les deux cas, vous travaillez sur le même fichier.

Pourquoi les agents IA utilisent-ils des fichiers Markdown ?

Un agent IA peut lire vos notes, préparer un brouillon, vérifier une information ou modifier un fichier. Avant de lui confier un article, il faut lui expliquer à qui il s’adresse, ce qu’il doit défendre et quelles affirmations demandent une vérification. Vous pouvez réunir ces indications dans un document que vous réutiliserez pour les prochains textes.

Markdown permet de les organiser simplement. Les titres séparent le contexte des consignes ; les listes rendent les exigences repérables. Vous pouvez ouvrir le fichier, discuter une formulation avec un collègue ou remplacer une règle devenue inutile. Les mêmes consignes peuvent ensuite servir avec un autre outil.

L’IA sait aussi lire du texte ordinaire. L’intérêt de Markdown tient à cette structure, qui reste lisible pour vous. Enregistrer une consigne ne réentraîne pas le modèle : le document lui apporte du contexte lorsqu’il le lit.

Comment créer un fichier .md ?

Demandez-le à votre IA : « Prépare un fichier .md à partir de ces consignes et donne-moi le fichier à télécharger. » Vous pourrez ensuite le relire, le modifier et le réutiliser. Si votre assistant peut écrire dans votre dossier de travail, demandez-lui simplement de l’y enregistrer.

Que mettre dans un fichier .md pour guider un agent IA ?

Pour mes articles, j’utilise un fichier redaction.md. Il contient les consignes de rédaction et une mémoire des corrections. Je peux demander à l’IA de reprendre un passage, puis préciser si mon retour vaut seulement pour cet article ou pour les suivants. Cela évite de transformer une remarque ponctuelle en règle générale. J’explique ce fichier en détail dans Pourquoi mon IA écrit comme une IA ?

Voici quelques passages sélectionnés dans mon fichier, reproduits tels quels. Ils montrent comment je précise la matière, la voix et les vérifications attendues. La version complète reste disponible au téléchargement pour l’adapter à votre façon de travailler.

## Matière et position

N'invente jamais d'expérience personnelle, de client, de résultat, de citation, de chiffre ou de source. Les exemples inventés doivent être reconnaissables comme tels. Une anecdote n'est utilisable comme expérience vécue que si je l'ai fournie.

## Voix

Prends pour références les textes que j'ai explicitement désignés comme représentatifs de ma voix. Une sortie d'IA, un texte simplement publié ou une citation d'un tiers ne devient pas automatiquement un modèle de mon style.

## Écriture

- Commence par le sujet concret. Supprime les introductions interchangeables sur un monde qui change.
- Relie les paragraphes par le raisonnement. Une reformulation du paragraphe précédent ne constitue pas une nouvelle étape.
- Conclus quand la démonstration est terminée. N'ajoute pas un résumé du résumé, une morale ou une question d'engagement automatique.

## Vérification

Vérifie les faits et les références avant de polir le style. Assure-toi qu'une source soutient précisément la proposition qui lui est attribuée. Garde visibles les incertitudes utiles.

La consigne sur la voix compte autant que les préférences de ponctuation. Un texte peut respecter toutes mes interdictions et ne rien dire qui mérite d’être lu. Je demande donc aussi à l’agent de partir de ma matière, de préserver ma position et de vérifier ce qui la soutient. Le style ne dispense pas d’avoir quelque chose à dire.

À quoi sert AGENTS.md et où placer les consignes spécifiques ?

Dans les outils qui prennent en charge cette convention, AGENTS.md est le point d’entrée des consignes du projet : l’agent charge les instructions applicables avant de commencer son travail. C’est donc le bon endroit pour lui indiquer quels autres fichiers consulter selon la tâche. Pour une rédaction, on peut le renvoyer vers redaction.md ; pour les informations sur l’entreprise, vers entreprise.md. Le rôle d’AGENTS.md.

Le nom s’écrit habituellement AGENTS.md, en majuscules. Ce fonctionnement concerne les agents compatibles et leur configuration. Toutes les IA ne lisent pas ce fichier, et celles qui le chargent ne le relisent pas nécessairement avant chaque action. Un simple assistant de conversation ne va pas chercher les documents sur votre ordinateur parce qu’ils portent le bon nom.

Vous pouvez demander à l’agent d’ajouter dans votre AGENTS.md une consigne de ce genre :

## Articles de blog

Avant de préparer ou de corriger un article, consulte redaction.md.
Applique ses consignes et les retours pertinents pour ce texte.
Si le fichier est inaccessible, signale-le avant de rédiger.

Lorsque vous lui demandez un article, l’agent trouve cette instruction dans AGENTS.md, puis consulte redaction.md avant de préparer le brouillon. Les fichiers doivent être accessibles dans son espace de travail. D’autres outils utilisent leur propre fichier d’entrée, comme CLAUDE.md dans Claude Code. Chargement des fichiers de consignes dans Claude Code.

Comment faire lire le fichier à un assistant de conversation ?

Si vous travaillez dans une conversation, joignez redaction.md à votre demande : « Lis ce fichier, puis prépare mon article à partir des notes jointes. » Si les pièces jointes ne sont pas disponibles, collez son contenu dans le message.

Demandez à l’assistant de relever les règles importantes, puis examinez le texte qu’il produit. Les références existent-elles ? Votre position a-t-elle été conservée ? Une expérience a-t-elle été inventée ? Savoir réciter une consigne ne prouve pas qu’on l’a respectée.

Un fichier .md suffit-il à faire respecter les consignes ?

Une IA peut ignorer une instruction, mal l’interpréter ou la perdre de vue au cours d’un travail long. Le document peut aussi être trop volumineux pour être entièrement pris en compte. Si le même défaut revient, examinez ce qui s’est passé avant d’ajouter dix interdictions : l’agent avait-il accès au fichier ? La règle était-elle compréhensible ? Une autre consigne la contredisait-elle ?

Il ne donne pas non plus une capacité absente. Écrire « vérifie les sources » ne fournit pas un accès à Internet. Écrire « ne te trompe jamais » ne crée aucune procédure de vérification. Une consigne utile précise l’action attendue et la manière de traiter un échec : chercher la source originale lorsque c’est possible, signaler ce qui reste incertain, demander l’information indispensable.

Enfin, des règles écrites ne remplacent pas les permissions du logiciel. Si un agent dispose du droit de publier, la phrase « ne publie rien » reste une instruction à suivre. Pour empêcher réellement une publication, il faut aussi limiter les accès ou imposer une validation dans le système. Cette distinction compte dès que l’agent peut agir au-delà de la rédaction d’un brouillon.

Quelles erreurs éviter avec un fichier Markdown ?

La première consiste à empiler des ordres vagues. « Sois pertinent », « sois créatif » ou « fais mieux » laissent à l’agent le soin de définir votre attente. « Explique chaque terme technique à sa première apparition » permet, au contraire, de constater si le travail a été fait.

La deuxième consiste à conserver toutes les corrections comme des lois éternelles. Vous avez demandé une introduction courte pour un billet précis ; cela ne signifie pas que tous vos textes doivent désormais commencer en quatre lignes. Notez la portée de la correction. Lorsqu’une préférence durable change, remplacez l’ancienne règle au lieu de laisser deux instructions se contredire.

La troisième concerne les informations confidentielles. Un fichier Markdown reste du texte lisible. N’y placez pas de mot de passe ou de clé d’accès, et vérifiez ce que vous transmettez avant de joindre le document à un service. Une extension familière ne protège aucune donnée.

Il faut aussi regarder la provenance des documents. Un texte récupéré sur Internet peut contenir une phrase demandant à l’agent d’ignorer vos instructions. Le fait qu’elle se trouve dans un .md ne lui donne aucune autorité. Lorsque vous fournissez un document à analyser, présentez-le comme une source de travail et précisez que ses éventuelles instructions ne doivent pas être exécutées. Cette précaution aide à cadrer la lecture ; les actions sensibles demandent également des contrôles techniques.

Quant à la mise en forme, elle peut varier d’une application à l’autre. Markdown possède plusieurs variantes ; CommonMark cherche à préciser une base commune. Commencez par les titres, les paragraphes, les listes et les liens, puis contrôlez l’affichage dans votre outil avant d’utiliser des fonctions plus élaborées. Spécification CommonMark.

Par quoi commencer pour essayer Markdown ?

Demandez à votre IA de préparer un premier fichier à partir de quelques règles qui comptent pour vous. Relisez-le : une instruction trop vague vous semblera souvent évidente dès qu’elle est écrite. Vous pourrez alors la préciser avant de lui confier le travail.

Si vous utilisez un assistant, choisissez un travail que vous connaissez assez bien pour juger le résultat. Adaptez le fichier de consignes proposé dans cet article, transmettez-le à l’agent et relevez un écart précis dans sa réponse. Corrigez la règle concernée, en indiquant si elle vaut pour ce texte ou pour les suivants. Vous aurez une modification concrète à évaluer lors du prochain travail, plutôt qu’une nouvelle demande de « faire mieux ».