PreviewMD pour Mac, iPad et iPhone
Obtenir

Ce qu’est le Markdown, d’où il vient et à quoi il sert

Réponse courte : le Markdown est une manière d’écrire du texte mis en forme dans un fichier texte brut, avec des marques qu’un humain lit sans aucun programme. Une ligne qui commence par # est un titre, **comme ceci** est en gras, une ligne qui commence par - est un élément de liste. Un convertisseur en fait du HTML ; un humain s’y retrouve dans les deux cas. Cette double vie — lisible comme du texte, composable comme un document — c’est toute l’idée, et la raison pour laquelle il a survécu à tous les formats plus sophistiqués venus le remplacer.

D’où il vient

Le Markdown a été publié en mars 2004 par John Gruber, qui l’a écrit avec Aaron Swartz. L’implémentation était un script Perl d’environ 1 400 lignes appelé Markdown.pl, et l’objectif était annoncé sans détour : les gens qui écrivaient pour le web étaient fatigués de taper des balises HTML à la main, et le courrier électronique avait déjà appris à tout le monde comment baliser un texte à la légère.

Ce dernier point compte, parce que le Markdown n’a pas inventé ses marques. Il les a ramassées parmi les conventions que les gens utilisaient déjà dans les e-mails en texte brut :

  • entourer un mot d’astérisques pour l’emphase, ce que Usenet et le courrier faisaient depuis vingt ans
  • citer une réponse en préfixant les lignes de >, ce que faisait chaque logiciel de messagerie
  • souligner un titre avec === ou ---, venu de Setext, un format de 1992 signé Ian Feldman
  • mettre un # devant un titre, venu d’atx, écrit par Aaron Swartz en 2002

L’apport de Gruber, c’est la sélection et la règle qui la guide : un document Markdown doit se lire comme un document en texte brut, pas comme un document couvert de balises. Rien dans la syntaxe ne doit ressembler à du balisage pour un lecteur qui ignore que le Markdown existe.

Le nom est une plaisanterie aux dépens du markup, le balisage, et la licence d’origine était assez permissive pour que n’importe qui puisse le réimplémenter — ce que tout le monde a fait.

Pourquoi il s’est répandu

Le Markdown est arrivé sans comité, sans entreprise et sans norme, et il s’est pourtant retrouvé partout. Trois propriétés y ont suffi.

C’est du texte brut, donc tous les outils savent déjà le traiter. La gestion de versions le compare ligne à ligne et te montre ce qui a changé dans un paragraphe — essaie avec un fichier de traitement de texte. La recherche le trouve. Un script peut le produire. Il survit à un envoi par mail, à un collage dans un chat et à une recopie. Dans quarante ans, il s’ouvrira encore.

L’apprendre coûte environ cinq minutes. Trois marques suffisent pour être efficace, le reste se découvre au besoin. Rien n’est caché derrière une barre d’outils.

Il reste lisible sans rendu. Un lecteur sans moteur de rendu voit des astérisques et des dièses, mais lit le texte dans le bon ordre, la structure visible. Aucun format binaire n’offre ça.

Les plateformes qui l’ont adopté tôt en ont fait une valeur par défaut. Stack Overflow a démarré en 2008 avec un éditeur Markdown. GitHub affichait README.md sur les pages de projet et, de là, « écris ton README en Markdown » est devenu la convention de tout un secteur. Jekyll, sorti la même année, transformait des dossiers de fichiers Markdown en sites web, et GitHub Pages les servait gratuitement.

En 2016, le format était assez répandu pour être enregistré auprès de l’IANA comme type de média text/markdown, dans la RFC 7763.

Les dialectes, et pourquoi il y en a plusieurs

La description d’origine de Gruber laissait des cas indéfinis — ce qui arrive quand une liste est interrompue, comment l’emphase s’imbrique au milieu d’un mot, ce que signifie un crochet égaré. Chaque implémentation tranchait autrement, si bien que le même fichier s’affichait différemment selon l’outil.

En 2014, un groupe comprenant John MacFarlane, l’auteur de Pandoc, a écrit une spécification précise avec une suite de tests. Elle a paru sous le nom de « Standard Markdown », Gruber s’est opposé au nom, et elle est devenue CommonMark. C’est cette spécification que suivent la plupart des moteurs de rendu aujourd’hui.

Dialecte Ce qu’il ajoute Où tu le croises
CommonMark La base précise : des règles sans ambiguïté et une suite de tests La plupart des bibliothèques et des éditeurs
GitHub Flavored Markdown Tableaux, listes de tâches, texte barré, liens automatiques, notes de bas de page, encarts d’alerte GitHub, GitLab, la plupart des README
MultiMarkdown Citations, renvois, métadonnées, meilleurs tableaux Écrits universitaires et textes longs
Pandoc Markdown Tout ce qui précède plus les maths, les figures et la sortie en PDF, Word, LaTeX Articles, livres, thèses
MDX Des composants écrits en JSX, intégrés dans le texte Sites de documentation bâtis avec React

Le GFM est ce que la plupart des gens veulent dire aujourd’hui quand ils disent Markdown : du CommonMark plus les extensions que GitHub a spécifiées en 2017. PreviewMD rend le GFM, avec les maths par KaTeX et les diagrammes par Mermaid.

À quoi les gens s’en servent

Documentation et READMEs. Le choix par défaut pour tout ce qu’un développeur lit : readmes de projet, journaux des modifications, notes d’architecture, procédures d’exploitation. Les sites de documentation — MkDocs, Docusaurus, Hugo, Astro — sont surtout des dossiers de Markdown avec un thème par-dessus.

Les notes. Obsidian, Bear, iA Writer, Logseq et une douzaine d’autres rangent les notes dans des fichiers Markdown, ce qui veut dire que tes notes ne sont pas prisonnières : tu peux les lire avec n’importe quel éditeur, les sauvegarder avec n’importe quel outil et passer à une autre app sans étape d’export.

Écrire pour le web. Sites statiques, infolettres et blogs, là où l’auteur veut écrire de la prose et pas du balisage. Le texte que tu lis est un fichier Markdown ; le sélecteur en haut de cette page te le montre.

Partout où un champ de texte accepte la mise en forme. Les gestionnaires de tickets, les pull requests, les apps de discussion, les forums et les wikis utilisent le Markdown ou un proche parent.

Parler aux machines. Les modèles de langage produisent du Markdown par défaut, ce qui en a discrètement fait la langue commune entre les gens et les outils d’IA — les titres, les listes et les blocs de code dans la réponse d’un assistant, c’est du Markdown rendu.

Ce qu’il fait mal

Le Markdown est un format de structure, pas de mise en page. Il n’a aucun moyen de dire où une chose se place sur la page, quelle largeur fait une colonne ou quelle police employer — et c’est volontaire, parce que ces décisions appartiennent à ce qui affiche le document.

Il convient donc mal quand la forme de la page est le sujet : un prospectus, un formulaire, une double page de magazine. Les tableaux complexes à cellules fusionnées sont pénibles et finissent généralement en HTML. Et pour l’écriture universitaire avec citations et renvois, le Markdown seul ne suffit pas — c’est précisément à cela que servent les extensions de Pandoc et de MultiMarkdown.

La frustration la plus courante — « mon fichier n’a pas la même allure dans une autre app » — vient presque toujours d’une différence de dialecte. Écrire en CommonMark plus GFM est le pari le plus sûr, parce que c’est là-dessus que le plus grand nombre d’outils s’accordent.

Le Markdown sur un Mac

macOS n’affiche pas nativement les fichiers .md : la barre d’espace montre du texte brut, et un dossier de notes ressemble à une pile d’icônes vides identiques.

PreviewMD corrige exactement cette partie — aperçus Coup d’œil, vignettes de documents et une fenêtre avec la page rendue à côté de sa source. Il rend le GitHub Flavored Markdown, avec les maths KaTeX et les diagrammes Mermaid embarqués, de sorte que rien n’est téléchargé pendant le rendu d’un document.

L’aide-mémoire liste chaque marque avec ce qu’elle produit, et comment ouvrir un fichier .md sur un Mac couvre le côté pratique.