Mode d'emploi
- Collez le HTML dans HTML. L'exemple montre un titre, un paragraphe avec emphase et un lien, et une liste.
- Lisez Markdown (CommonMark) : il se met à jour pendant la saisie.
- Copiez-le avec le bouton de copie, et enregistrez-le comme fichier .md, ou collez-le dans un éditeur Markdown.
Ce qui est converti, et comment
Les titres h1 à h6 deviennent des titres ATX, avec une à six marques #. strong et b deviennent texte en gras, et em et i deviennent *texte en italique*. Un élément code devient une portion de code, et un élément pre un bloc de code délimité, dont la langue est conservée lorsque le code porte une classe language-. Un br devient un saut de ligne strict, une blockquote reçoit un > devant chaque ligne, et ul et ol deviennent des listes avec - ou un numéro. Un élément a avec un href devient un lien, et une img avec un src devient une image avec son texte alternatif (sections 4.2, 4.5, 5.1, 5.2, 6.1, 6.2, 6.3 et 6.7 de CommonMark).
Un caractère que le Markdown lirait comme balisage est échappé par une barre oblique inverse : l'astérisque, le tiret bas, l'accent grave, les crochets et le chevron, ainsi qu'une ligne qui commencerait comme un titre, une citation ou une liste. La section 2.4 de CommonMark permet une barre oblique inverse devant tout caractère de ponctuation ASCII.
Ce qui n'est pas conservé
Les scripts, les styles, les modèles, les cadres, les contrôles de formulaire et les médias sont omis avec leur contenu. Les attributs autres que href, src, alt et title sont supprimés. CommonMark n'a ni tableau, ni soulignement, ni couleur : un tableau devient donc un paragraphe par cellule, et le texte de u, span et d'éléments semblables est conservé sans sa mise en forme.
Trois éléments et un caractère à échapper
Chaque fragment HTML du tableau donne le Markdown de la colonne de droite, tel que l'outil l'écrit.
| Ce que contient le HTML | Markdown |
|---|---|
| Un titre de niveau 2 avec le texte Notes | ## Notes |
| Un paragraphe avec du texte en gras | Du texte en **gras** |
| Une liste avec un seul élément, Premier | - Premier |
| Le texte 5 * 3 = 15, avec un astérisque | 5 * 3 = 15 |
Questions fréquentes
Pourquoi le Markdown contient-il des barres obliques inverses ?
Une barre oblique inverse indique que le caractère suivant est du texte et non du balisage, comme un astérisque ou un crochet. CommonMark la retire au rendu (section 2.4) : la page affiche donc les caractères tels qu'ils étaient dans le HTML.
L'outil exécute-t-il mon HTML ou le garde-t-il sur la page ?
Non. Le HTML est analysé par DOMParser dans un document séparé, qui n'a pas de contexte de navigation et n'exécute pas de scripts. L'outil copie son texte et sa structure, et affiche le Markdown comme du texte.
Pourquoi les tableaux deviennent-ils des paragraphes ?
CommonMark n'a pas de syntaxe de tableau : les tableaux à barres verticales que certains services ajoutent sont une extension. Chaque cellule devient un paragraphe : les mots sont gardés, mais la mise en page du tableau ne l'est pas.
Les liens et les images sont-ils conservés ?
Oui. Un élément a avec un href devient un lien, avec son title s'il en a un, et une img avec un src devient une image dont le texte alternatif est échappé. Les autres attributs ne sont pas conservés.
Que deviennent les éléments qui n'ont pas de forme en Markdown ?
Leur texte reste et leur mise en forme disparaît. Par exemple, span, u et mark gardent les mots qu'ils contiennent, et un div ou une section commence un nouveau paragraphe de texte.
Sources
- CommonMark (en anglais) : Spec, version 0.31.2, sections 2.4, 4.1, 4.2, 4.4, 4.5, 5.1, 5.2, 6.1, 6.2, 6.3 et 6.7
- WHATWG (en anglais) : HTML Standard, section 8.5.1, The DOMParser interface
- MDN Web Docs (en anglais) : DOMParser
Chiffres et texte vérifiés pour la dernière fois le mardi 10 novembre 2026.