La typographie française exige une espace insécable avant : ; ! ? et à l'intérieur des guillemets « » — un caractère invisible qui peut disparaître silencieusement quand un texte Markdown est copié-collé, réencodé ou traité par un outil qui ignore les espaces Unicode non standards.
Syntaxe de base
# Titre— des titres à différents niveaux selon le nombre de caractères#.**gras**et*italique*— mise en emphase du texte.[texte](url)— un lien.- élémentou1. élément— listes à puces et numérotées.- ``` — blocs de code avec coloration syntaxique selon le nom du langage.
L'espace insécable, invisible mais essentielle
En français, écrire « Bonjour ? » sans l'espace fine avant le point d'interrogation est considéré comme une faute de typographie. Cette espace (U+00A0 ou U+202F) est un caractère à part entière, distinct de l'espace normale — mais dans un fichier Markdown brut, elle est visuellement identique à une espace ordinaire, donc un correcteur automatique ou un simple copier-coller depuis une messagerie peut la remplacer par une espace normale sans que personne ne le remarque avant le rendu final.
Le Markdown original ne définissait ni tableaux ni CommonMark n'existait
Le Markdown publié par John Gruber en 2004 était une description en prose, pas une grammaire formelle, et ne prévoyait ni tableaux, ni texte barré, ni blocs de code avec langage indiqué. Pendant dix ans, chaque implémentation a comblé les zones grises du texte original à sa façon, jusqu'à ce que CommonMark, en 2014, fixe une grammaire précise — et GitHub Flavored Markdown (GFM) a ajouté par-dessus les tableaux et listes de tâches qui semblent aujourd'hui aller de soi dans n'importe quel README.
Convertir en HTML et inversement
La conversion Markdown → HTML est directe : un analyseur reconnaît les constructions syntaxiques et génère les balises correspondantes. La conversion inverse, HTML → Markdown, est plus délicate, car HTML prend en charge bien plus d'options de mise en forme que le Markdown de base, donc une partie du balisage (tableaux complexes, styles imbriqués) peut être simplifiée ou perdue.
À quoi ça sert
- Prévisualiser rapidement le rendu d'un fichier Markdown sans le publier.
- Convertir le contenu d'une page ou d'un document en Markdown pour le stocker dans un système de contrôle de version.
- Préparer du contenu HTML pour l'insérer dans une application qui n'accepte que le Markdown.