Qu'est-ce que le Markdown, et comment lire un fichier .md ?

Quelqu'un vous a envoyé un fichier dont le nom se termine par .md, ou bien vous avez sous les yeux un texte parsemé d'astérisques, de dièses et de crochets : **comme ceci**, # comme cela. Au premier regard, cela semble cassé. Ce n'est pas cassé, c'est mis en forme, et cette façon d'écrire s'appelle le Markdown.

L'idée est simple. Au lieu d'aller chercher des boutons pour mettre le texte en forme, vous écrivez la mise en forme dans le texte lui-même, avec une poignée de marques. Un mot entouré d'astérisques devient gras ; une ligne qui commence par un dièse devient un titre. Un logiciel qui comprend ces marques en tire un document propre, et un logiciel qui ne les comprend pas affiche malgré tout un texte lisible, puisque rien n'y est caché.

Comment ouvrir un fichier .md

Un fichier Markdown n'est que de l'écrit ordinaire, ce qui veut dire que n'importe quel éditeur de texte l'ouvrira. Lancez l'éditeur, choisissez Ouvrir dans le menu Fichier, et réglez la liste des types de fichiers, dans le coin de la boîte de dialogue, sur « Tous les fichiers » — tant que cette liste indique « Documents texte », votre fichier .md n'apparaîtra tout simplement pas. Ce que vous obtenez, c'est le fichier entier, marques comprises.

Pour le voir mis en page plutôt que brut, deux possibilités. Vous pouvez l'ouvrir dans une application qui comprend le Markdown : beaucoup d'applications de prise de notes, d'éditeurs de code et de plateformes de dépôt l'affichent en forme dès le chargement. Ou vous pouvez convertir le texte en HTML et ouvrir ce résultat dans un navigateur, ce qui est la voie la plus commode quand il faut transmettre le document ou le déposer dans une page web.

Si vous ne voyez pas l'extension du tout — le nom du fichier ne se termine pas par .md à l'écran —, cochez « Extensions de noms de fichiers » sous l'onglet Affichage de l'Explorateur de fichiers, sous Windows. Voir l'extension est le moyen le plus rapide de comprendre à quel logiciel un fichier appartient.

Un mot pour le français et pour l'arabe : comme le fichier est du texte nu, les lettres accentuées et les caractères non latins n'y survivent que si l'éditeur enregistre en UTF-8. La plupart des éditeurs modernes le font d'office, mais si vos accents reviennent en désordre après un aller-retour, c'est le réglage à vérifier au moment de l'enregistrement.

Les marques que vous rencontrerez vraiment

Il n'est pas nécessaire d'apprendre tout le Markdown ; l'écriture quotidienne tient presque entièrement dans les marques ci-dessous. Lire le tableau une fois suffit à décoder n'importe quel texte qui vous tombe entre les mains.

Surveillez un détail : la plupart de ces marques se placent tout au début de la ligne et sont suivies d'une espace. Oubliez l'espace entre le dièse et le texte du titre, et la ligne restera exactement telle que vous l'avez tapée.

Où l'on croise le Markdown

Comme le Markdown transporte sa mise en forme à l'intérieur du texte, cette mise en forme ne peut jamais être perdue en route. C'est pourquoi il est préféré partout où l'écrit passe de main en main.

On le rencontre surtout dans les dépôts de code : le fichier README qui présente un projet est du Markdown presque sans exception. Au-delà, les applications de notes, les wikis d'équipe, les forums, les messageries et les moteurs de blog utilisent la même notation. Les astérisques que vous voyez dans un texte copié depuis une conversation avec une intelligence artificielle, ce sont eux aussi.

Face à un traitement de texte, la différence est celle-ci. Dans un document Word, la mise en forme vit à un endroit que vous ne voyez pas, et le logiciel qui ouvre le fichier doit la comprendre. En Markdown, la mise en forme est sous vos yeux. Le prix à payer, c'est que les mises en page élaborées — colonnes multiples, notes de bas de page, numéros de page — n'existent tout simplement pas en Markdown : il a été conçu pour des documents courts et plats.

Convertir le texte en HTML

Si le texte est destiné à une page web, à un système de gestion de contenu ou au corps d'un courriel, une étape de traduction s'intercale : le HTML. Collez le texte dans l'outil Markdown vers HTML et les titres, les listes et les liens deviennent les balises correspondantes.

Deux sorties sont proposées, et le choix dépend de la destination. Si la page existe déjà — un billet publié en ligne, un modèle de courriel —, prenez la première : elle s'arrête au contenu et laisse l'enveloppe tranquille. Si vous voulez un fichier qui s'ouvre seul d'un double-clic, prenez la seconde, qui ajoute cette enveloppe autour.

La couverture s'arrête au vocabulaire courant : titres, gras, italique, listes, citations, liens et code. Un tableau, une image ou une liste à plusieurs niveaux n'est pas transformé ; sa marque reste visible dans le résultat au lieu de s'évaporer, ce qui vous permet de la repérer et de terminer ces passages vous-même.

Les tableaux : le standard et ses dialectes

La définition d'origine du Markdown ne comporte aucun tableau. Les tableaux sont arrivés plus tard, par des extensions ajoutées par telle ou telle plateforme ; c'est pourquoi le même tableau s'affiche correctement à un endroit et ressort ailleurs en ligne après ligne de texte brut. Regardez où vous comptez publier avant d'en écrire un.

La notation construit les colonnes avec des barres verticales et réclame une ligne de séparation juste sous la ligne d'en-têtes. Les barres sont la seule chose qui compte pour le rendu : les espaces autour du texte des cellules servent à vos yeux, pas au logiciel. Écrire tout cela à la main devient fastidieux au bout de quelques lignes, et l'alignement se décale vite.

Deux habitudes rendent la tâche supportable. La première : composez le tableau dans un éditeur qui affiche une police à chasse fixe, où chaque caractère occupe la même largeur ; les colonnes se rangent alors visuellement pendant que vous tapez. La seconde : si vos données sont déjà dans un tableur, collez-les d'abord dans le document, une ligne par ligne, puis ajoutez les barres verticales en une seule passe — vous éviterez de recompter les colonnes à chaque enregistrement.

Quatre erreurs que tout le monde répète

Les marques du Markdown sont simples, donc les fautes se concentrent toujours aux mêmes endroits. Quand un texte ne rend pas ce que vous aviez en tête, commencez par celles-ci.

• L'espace oubliée : il en faut une entre le dièse et le texte du titre, et entre le tiret et le texte de l'élément. « #Titre » n'est pas un titre ; « # Titre » en est un.
• Les lignes qui se recollent : deux lignes tapées l'une sous l'autre comptent pour un seul paragraphe dans la plupart des environnements. Si vous voulez des paragraphes distincts, laissez une ligne vide entre les deux.
• Quand l'astérisque est vraiment un astérisque : celui qui sert d'appel de note ou qui figure dans un tarif peut être pris pour de la mise en forme. Placez une barre oblique inverse devant (\*) et il reste tel que vous l'avez tapé.
• Confondre image et lien : une notation qui commence par un crochet est un lien ; mettez un point d'exclamation devant et cela devient une image. Oubliez le point d'exclamation et vous obtenez un lien vers l'adresse de l'image au lieu de l'image elle-même.

Questions fréquentes

À quoi sert le Markdown ?

C'est une façon simple d'écrire dans laquelle la mise en forme s'exprime à l'intérieur du texte, avec quelques marques. Un mot entre astérisques est en gras ; une ligne qui commence par un dièse est un titre. Comme le fichier est du texte brut, il s'ouvre partout et la mise en forme ne peut pas se perdre en chemin.

Comment ouvrir un fichier .md ?

Dans un éditeur de texte, choisissez Ouvrir dans le menu Fichier et réglez la liste des types sur « Tous les fichiers » ; le fichier est de l'écrit ordinaire. Pour le voir mis en page, ouvrez-le dans une application qui comprend le Markdown, ou convertissez le texte en HTML et regardez le résultat dans un navigateur.

Comment convertir du Markdown en HTML ?

Collez le texte dans l'outil Markdown vers HTML : les titres, les listes et les liens deviennent des balises. Prenez la première sortie si la page où vous collez existe déjà, et la seconde si vous voulez un fichier qui s'affiche seul d'un double-clic.

Peut-on écrire des tableaux en Markdown ?

Pas dans la définition d'origine ; les tableaux viennent d'extensions ajoutées par certaines plateformes, ils ne s'affichent donc pas partout de la même façon. Vérifiez d'abord ce que reconnaît l'endroit où vous publiez, puis construisez les colonnes avec des barres verticales et une ligne de séparation sous les en-têtes.

Quelle différence entre le Markdown et Word ?

Dans Word, la mise en forme est stockée à un endroit que vous ne voyez pas ; en Markdown, elle est dans le texte, en pleine vue. Le Markdown voyage mieux, mais il ne gère pas les mises en page élaborées comme les colonnes multiples, les notes de bas de page ou les numéros de page.

Dernière mise à jour : 27 août 2026