Convertisseur HTML en Markdown

Comment convertir du HTML en Markdown

1. Choisissez le sens : HTML → Markdown ou Markdown → HTML.
2. Collez votre code dans la zone de saisie, ou cliquez sur Ouvrir un fichier pour charger un fichier .html, .htm, .md ou .txt (10 Mo au maximum).
3. Réglez les options. Dans le sens HTML → Markdown, vous pouvez choisir le style des Titres, la Puce des listes et le style des Blocs de code. Dans le sens Markdown → HTML, l’option Nettoyer le HTML (retirer scripts et gestionnaires d’événements) est cochée par défaut.
4. Cliquez sur Convertir. Le résultat se met aussi à jour pendant la saisie.
5. Copiez ou téléchargez le résultat. Inverser le sens replace le résultat dans la zone de saisie : pratique pour vérifier l’aller-retour.

L’Aperçu affiché sous le résultat montre le rendu du Markdown, ce qui permet de contrôler la conversion d’un coup d’œil.

Ce que fait la conversion HTML → Markdown

Cet outil lit votre HTML avec l’analyseur du navigateur, dans un document inerte : aucun script ne s’exécute et aucune image n’est téléchargée. Il parcourt ensuite la structure de la page et écrit l’équivalent Markdown de chaque élément :

• les balises <h1> à <h6> deviennent des titres. Le style ATX (# Titre) utilise # à ###### ; le style Setext (soulignés) souligne les titres de niveau 1 et 2 avec === ou --- (les niveaux 3 à 6 gardent les #) ;
• <strong> et <b> donnent du **gras**, <em> et <i> de l’_italique_, et le <code> en ligne passe entre accents graves ;
• les liens deviennent [texte](url "titre") et les images ![alt](src) ;
• les listes utilisent la puce choisie (-, * ou +) ; les listes numérotées conservent leur numéro de départ, et les sous-listes sont indentées ;
• <pre><code> devient un bloc de code, Délimités (```) ou Indentés (4 espaces) ;
• les citations <blockquote>, les séparateurs <hr> et les sauts de ligne sont aussi convertis ;
• <script>, <style>, <iframe>, <noscript> et les éléments du même genre sont supprimés avec leur contenu.

Les caractères qui seraient pris pour de la syntaxe Markdown, comme un * ou un # en début de ligne, sont précédés d’une barre oblique inverse pour rester du texte.

Markdown GitHub (GFM)

Quand l’option Markdown GitHub (tableaux, ~~barré~~, listes de tâches) est cochée :

• les tableaux deviennent des tableaux à barres verticales, aux colonnes alignées. L’en-tête provient d’une ligne <thead> ou d’une ligne composée uniquement de cellules <th> ; à défaut, une ligne d’en-tête vide est ajoutée, car le format GFM l’exige. L’alignement est repris de align="right" ou de style="text-align: center". Les barres verticales dans les cellules sont échappées en \|, les sauts de ligne deviennent <br> et un colspan est complété par des cellules vides. Une légende <caption> est placée en paragraphe au-dessus du tableau ;
• <del>, <s> et <strike> donnent du texte ~~barré~~ ;
• les cases à cocher en début d’élément de liste deviennent des listes de tâches : - [x] fait, - [ ] à faire.

Le Markdown ne sait pas représenter les tableaux imbriqués, les lignes fusionnées ni la mise en forme des cellules. Un tableau qui en contient un autre est donc conservé en HTML brut, ce que la plupart des moteurs Markdown acceptent. Sans l’option GFM, tous les tableaux restent en HTML.

Du Markdown vers le HTML

Dans l’autre sens, le Markdown est interprété par un analyseur conforme à CommonMark, avec les extensions GFM si l’option est cochée. Vous obtenez un fragment HTML prêt à coller dans un CMS, un modèle de courriel ou une page web. Avec Nettoyer le HTML (retirer scripts et gestionnaires d’événements), le HTML brut glissé dans le Markdown est assaini : balises <script>, attributs onclick et liens javascript: sont retirés. Ne décochez l’option que pour du Markdown que vous avez écrit vous-même.