Dès que vous commencez à utiliser un agent IA comme Claude Code ou Codex, votre ordinateur se remplit de fichiers « .md » : le CLAUDE.md où vous écrivez vos instructions pour l’agent, mais aussi les résultats de recherche et les plans de travail que l’agent rédige pour vous. Ce sont tous des fichiers texte écrits dans un format appelé Markdown.
Pourtant, un double-clic sur un fichier .md ne l’ouvre souvent pas de façon lisible. Cet article présente Markdocx, une app pour Mac et Windows qui permet de lire et de modifier les fichiers .md, aux personnes qui utilisent des agents IA.
Les agents IA travaillent avec des fichiers .md
Quand vous travaillez avec un agent IA, les fichiers .md servent à deux choses : les instructions et les résultats.
Les instructions pour l’agent
Claude Code lit CLAUDE.md chaque fois qu’il se met au travail. Notez-y votre façon de travailler, les règles à respecter et le style d’écriture que vous préférez : vous n’aurez plus à les expliquer à chaque fois.
| Fichier | Lu par | Rôle |
|---|---|---|
| CLAUDE.md dans le dossier du projet | Claude Code | Les instructions pour ce projet. La commande /init peut en créer une première version |
| ~/.claude/CLAUDE.md | Claude Code | Vos préférences personnelles, pour tous les projets |
| AGENTS.md | Codex (Claude Code peut aussi le lire) | Les instructions pour le projet |
~/.claude est un dossier caché dans votre dossier de départ. Dans le Finder sur Mac, appuyez sur Command + Shift + . (point) pour afficher les dossiers cachés.
Les instructions ne s’écrivent pas une fois pour toutes. Vous les relisez en observant le travail de l’agent, vous les complétez et vous les faites évoluer.
Les résultats de l’agent
Rapports de recherche, plans de travail, résumés des modifications, fichiers README : ce que vous rend un agent arrive souvent, lui aussi, sous forme de fichiers .md. Markdown marque les titres, les listes et les tableaux avec des symboles : facile à écrire pour une IA, et d’une structure facile à suivre pour un humain. Quand l’agent explique un processus ou une organisation, il ajoute souvent un diagramme écrit dans un format appelé Mermaid.
Mais les fichiers .md sont difficiles à lire
Un fichier .md est un texte dans lequel les titres sont marqués par « # », le gras par « ** » et les tableaux par « | ». Et, curieusement, peu d’apps le mettent au propre quand vous double-cliquez dessus.
- Sur Mac, il s’ouvre dans une app comme TextEdit avec tous les symboles visibles, ou bien c’est une app pour développeurs qui s’ouvre
- Le Bloc-notes de Windows 11 sait désormais afficher une mise en forme simple, comme les titres, le gras et les listes. Mais les tableaux, la coloration du code et les diagrammes Mermaid, si fréquents dans les résultats d’un agent, ne font pas partie de ce qu’il affiche
Pour les lire correctement, il faut les coller dans un service web ou ouvrir un aperçu dans un éditeur pour développeurs : une étape de plus. La refaire à chaque rapport que vous rend l’agent devient vite pénible. Et quand vous modifiez CLAUDE.md, vous réécrivez un texte truffé de symboles.
Avec Markdocx, un double-clic pour lire, et on modifie sur place
Markdocx est une app pour Mac et Windows qui affiche un fichier .md comme un document propre dès son ouverture. Faites de Markdocx l’app des fichiers .md, et un double-clic suffira désormais. La marche à suivre est expliquée dans notre article sur une app pour ouvrir les fichiers .md.
Lire les résultats de l’agent comme un document propre
- Titres, listes, tableaux, listes de tâches et citations sont bien mis en forme, avec le code coloré selon le langage
- Les diagrammes Mermaid s’affichent comme des diagrammes. Dix types sont pris en charge, des organigrammes aux diagrammes de séquence, et ils sont dessinés sur votre ordinateur : vous les voyez même sans connexion Internet
- Les titres sont listés dans le plan à gauche : vous pouvez aller directement à n’importe quelle partie d’un long rapport
Modifier CLAUDE.md en gardant l’aperçu sous les yeux
- Placez l’éditeur et l’aperçu côte à côte. Ce que vous tapez apparaît aussitôt dans l’aperçu : vous vérifiez l’organisation de vos instructions sous chaque titre au fur et à mesure que vous les complétez
- La barre de mise en forme insère gras, liens, tableaux, listes et plus encore : inutile de retenir toute la syntaxe Markdown
- Votre travail est enregistré automatiquement, et un fichier .md reste un fichier .md. L’agent lira votre CLAUDE.md ou votre AGENTS.md modifié la prochaine fois qu’il se mettra au travail
Transmettre les résultats en Word ou en PDF
Il arrive que vous vouliez transmettre un rapport de l’agent à des collègues ou à des clients qui n’utilisent pas l’IA. Avec Markdocx, exportez-le en Word (.docx) ou en PDF depuis le bouton d’exportation de la barre d’outils. Titres, tableaux et code sont conservés, et les diagrammes Mermaid sont intégrés sous forme d’images : vos destinataires les voient avec Word, sans rien d’autre. Pour en savoir plus, consultez notre article sur Mermaid et l’exportation vers Word.
Lire et modifier, c’est gratuit pour toujours
Markdocx est disponible sur le Mac App Store et le Microsoft Store. Toutes les fonctions sont gratuites pendant les 14 premiers jours. Ensuite, ouvrir, lire et modifier des fichiers .md reste gratuit, sans limite de durée. Aucun compte n’est nécessaire. L’exportation vers Word, PDF et d’autres formats se débloque par un achat unique. Ce n’est pas un abonnement.
La version Mac fonctionne sous macOS 26 ou version ultérieure, et la version Windows sous Windows 11 et Windows 10 (version 1809 ou ultérieure).
