Markdown : l'essentiel à connaître

La révolution de l'intelligence artificielle (IA), propulsée par le deep learning et l'IA générative, a remis en lumière un outil pourtant vieux de plus de vingt ans. Autrefois réservé aux développeurs pour rédiger des documentations, le Markdown est devenu le format universel privilégié des modèles de langage (LLM). Ceci en raison du fait qu'il s'agit d'un langage de balisage léger qui permet de structurer un texte avec quelques symboles simples comme #, * ou -.

Il a été créé en 2004 par John Gruber pour écrire du texte lisible aussi bien par un humain que par une machine. Vingt ans plus tard, il est redevenu un outil central, notamment parce que les IA génératives comme Claude ou ChatGPT l'utilisent en permanence pour structurer leurs réponses et leurs instructions.

Qu'est-ce que le Markdown ?

Le Markdown a été en 2004 par John Gruber, avec la contribution d'Aaron Swartz. Leur idée était simple. Ils voulaient mettre en place permettre un langage de balisage qui permet d'écrire du texte destiné au Web sans avoir à manipuler directement le HTML, tout en conservant un document facile à lire dans sa forme brute.

Concrètement, le Markdown est une syntaxe d'écriture. Au lieu d'utiliser une barre d'outils pour mettre un texte en gras, créer un titre ou insérer une liste, on ajoute quelques symboles directement dans le texte. Lorsqu'il est interprété par un logiciel compatible, ce texte est automatiquement mis en forme.

Par exemple, si l'on écrit :

# Mon titre
**Ceci est important**

Le résultat affiché sera un grand titre suivi d'un texte en gras. Il n'est pas nécessaire de cliquer sur des boutons "Gras" ou "Titre 1" comme dans Word par exemple. La mise en forme fait partie de l'écriture.

C'est justement ce qui fait la force du Markdown. Même ouvert dans un simple bloc-notes, un fichier .md reste parfaitement lisible. Les symboles utilisés sont peu nombreux et suffisamment intuitifs pour que le contenu soit compréhensible au premier coup d'œil. À l'inverse, un document HTML est rapidement encombré par les balises. Ce qui rend sa lecture beaucoup moins agréable lorsqu'il est affiché en texte brut.

Pourquoi le Markdown redevient indispensable avec l'IA ?

Le Markdown existait déjà bien avant les IA génératives, popularisé par GitHub, les blogs techniques et les forums. Depuis des années, il est utilisé par les développeurs, mais avec l'arrivée de l'IA générative, son importance a pris une toute autre dimension.

Les IA écrivent et lisent en Markdown par défaut

Lorsque vous demandez à ChatGPT, Claude ou Gemini de rédiger un texte, il y a de fortes chances que la réponse soit affichée avec des titres, des listes, des tableaux ou des blocs de code. Cette mise en forme repose sur le Markdown, un format simple pour être généré facilement et assez riche pour produire un résultat clair et agréable à lire.

Pour les interfaces de chat, c'est un excellent compromis. Le texte reste léger, facile à transmettre et rapide à afficher, avec une présentation soignée.

Les "skills" et les instructions pour IA sont écrits en Markdown

Le Markdown ne sert pas seulement à afficher les réponses. Il est également très présent dans les coulisses des applications d'intelligence artificielle. En effet, de nombreux assistants, agents IA ou systèmes de prompts utilisent des fichiers Markdown pour organiser leurs instructions, leurs bases de connaissances ou leurs procédures. Ces fichiers peuvent être accompagnés de métadonnées au format YAML placées en début de document, mais l'essentiel du contenu reste écrit en Markdown.

Cela s'explique par le fait qu'un fichier Markdown, bien structuré avec des titres et des sections, est facile à parcourir pour un humain, mais aussi à analyser pour un programme qui doit retrouver rapidement une information précise.

Le Markdown est idéal pour le prompt engineering

Le Markdown est un outil apprécié pour le prompt engineering, c'est-à-dire l'art de formuler des instructions efficaces à une intelligence artificielle. Au lieu d'écrire un long bloc de texte, c'est plus pratique d'organiser son prompt avec des titres, des listes numérotées ou des sous-sections. Cette structure rend les consignes plus claires et limite les ambiguïtés.

Cela ne signifie pas que le simple fait d'utiliser du Markdown améliore automatiquement les performances d'un modèle. En revanche, une consigne bien organisée est généralement plus facile à interpréter, ce qui conduit souvent à des réponses plus pertinentes et plus cohérentes.

Comment utiliser le Markdown ?

L'un des principaux atouts du Markdown est sa simplicité. Vous n'avez pas besoin d'un logiciel particulier. Un simple éditeur de texte suffit pour créer un fichier portant l'extension .md. Cela dit, de nombreux outils rendent son utilisation encore plus agréable en affichant directement le résultat pendant la saisie. C'est notamment le cas de Typora, Obsidian ou iA Writer, qui permettent d'écrire en Markdown sans avoir l'impression de manipuler un langage de balisage.

Le Markdown est également très présent sur Internet. GitHub et GitLab l'utilisent pour les fichiers README des projets, la documentation ou les discussions. Si vous avez déjà consulté le dépôt d'un projet open source sur GitHub par exemple, il est très probable que la page d'accueil, les guides d'installation ou les tutoriels soient rédigés dans un fichier README.md.

On le retrouve aussi sur des plateformes comme Notion, Discord, Slack ou Reddit, qui prennent en charge tout ou partie de sa syntaxe pour mettre les messages en forme.

Pour commencer, rien de plus simple ! Créez un fichier texte, enregistrez-le en utilisant l'extension .md, puis commencez à écrire. Selon l'application utilisée, le document pourra ensuite être affiché tel quel ou converti automatiquement en HTML, en PDF ou dans d'autres formats.

Les principales syntaxes Markdown

Le Markdown repose sur un nombre limité de symboles. Une fois les quelques règles de base assimilées, vous n'aurez aucun mal à rédiger la plupart des documents.

Voici les syntaxes les plus utiles à connaître. Certaines, comme les tableaux ou les cases à cocher, font partie des extensions prises en charge par la majorité des outils modernes.

Avec ces quelques commandes, vous couvrirez déjà l'immense majorité des usages du Markdown. Le reste consiste principalement en des extensions proposées par certains outils, comme les notes de bas de page, les équations mathématiques ou les diagrammes.

Quelques règles pratiques pour éviter les erreurs courantes :

1. Laisser toujours une ligne vide avant et après un titre ou une liste.
2. Ne pas oublier l'espace après le # d'un titre, sinon il ne sera pas reconnu.
3. Utiliser des tirets - ou des astérisques * de façon cohérente dans une même liste.
4. Fermer les blocs de code avec les mêmes trois accents graves qui les ont ouverts.

Bonnes pratiques pour bien écrire en Markdown

• Un seul titre de niveau 1 par document. Il joue le rôle du titre principal, comme un H1 en HTML.
• Respecter une hiérarchie logique entre les titres, sans sauter de niveau 1 à niveau 3.
• Aérer le texte. Les paragraphes courts et les listes rendent le document plus lisible, autant pour un humain que pour une IA qui doit l'analyser.
• Éviter la mise en forme excessive. Trop de gras ou d'italique dilue leur effet.
• Tester le rendu avant publication, car certains outils interprètent de légères variantes de la syntaxe différemment.