Convertir du HTML en Markdown

Comment ça marche

Vous déplacez un ancien article de blog, une page de wiki ou une lettre d'information vers un outil qui fonctionne en Markdown : GitHub, Notion, Obsidian ou un générateur de site statique. Collez le HTML dans le panneau de gauche : le Markdown apparaît à droite. Par exemple <h2>Étapes</h2> devient ## Étapes, <strong>5 minutes</strong> devient **5 minutes**, une liste imbriquée garde son indentation et un tableau sort en tableau GFM avec des barres verticales. Si la classe d'un bloc de code indique un langage (language-bash), il est écrit sur la ligne de clôture. Les blocs script et style sont retirés ; tout ce qui concerne l'apparence n'a pas d'équivalent en Markdown et disparaît, le texte reste. La ligne de résultat compte titres, listes, tableaux, liens et blocs retirés.

Cet outil est aussi connu sous le nom de convertir html en markdown, html vers markdown, html to markdown, page web en markdown, html en md.

Qu'est-ce que Markdown ?

Markdown est une façon d'écrire du texte brut où la ponctuation indique la mise en forme : un dièse en début de ligne fait un titre, deux astérisques mettent en gras, un tiret ouvre un élément de liste. Le fichier se lit bien même sans rendu ; c'est pourquoi les fichiers README, les applications de notes et les sites de documentation l'utilisent.

Qu'est-ce que Tableau GFM ?

Un tableau GFM (GitHub Flavored Markdown) sépare les colonnes par des barres verticales et place sous la ligne d'en-tête une ligne de tirets. Le Markdown d'origine n'a pas de tableaux ; cette extension s'est répandue avec GitHub et la plupart des outils Markdown la lisent aujourd'hui. Elle ne gère ni cellules fusionnées ni cellules sur plusieurs lignes.

Quelle est la différence entre HTML et Markdown ?

HTML décrit au navigateur chaque détail d'une page : structure, apparence et comportement. Markdown ne porte que la structure et est pensé pour être lu par des personnes. En passant du HTML au Markdown, on garde titres, listes, tableaux, liens et mises en valeur, et on perd couleurs, polices et mise en page. C'est voulu : un texte en Markdown se lit partout de la même façon et se modifie facilement.

Ce que Markdown ne peut pas porter

Markdown ne décrit qu'une petite partie du HTML. Couleur, taille de police, alignement et mise en colonnes n'y ont pas de place ; ils sont retirés et le texte qu'ils contiennent est gardé.

Un tableau à cellules fusionnées (colspan, rowspan) ne peut pas s'écrire en tableau GFM. L'outil l'aplatit et ajoute « tableau à cellules fusionnées aplati » à la ligne de résultat ; vérifiez ce tableau dans la sortie.

Les caractères qui ont un sens en Markdown (astérisque, tiret bas, crochets) reçoivent une barre oblique inverse dans le texte normal, pour qu'un mot comme nom_fichier ne passe pas en italique.

Quelle option choisir

Les titres avec dièse fonctionnent presque partout et sont la seule écriture possible pour les niveaux trois à six. Les titres soulignés n'existent que pour les niveaux un et deux ; d'anciens fichiers README et certains outils de documentation les préfèrent. Avec cette option, le niveau trois et suivants gardent le dièse.

La liste de références garde lisibles les longs textes pleins de liens : le texte affiche seulement [page][1] et les adresses sont regroupées à la fin. Pour un texte court, les liens dans le texte sont plus simples.

Questions fréquentes

Puis-je coller une page web entière ?

Oui. La partie head, les scripts et les styles sont retirés, le contenu du body est converti. Le menu, le pied de page et la colonne latérale arrivent tout de même dans la sortie sous forme de texte ; si vous voulez seulement l'article, copiez uniquement cette partie du code source.

Que deviennent les images ?

Chaque image devient une ligne  ; l'image n'est pas téléchargée, seule son adresse est écrite. Les images intégrées dans la page (adresse qui commence par data:) sont laissées de côté car elles sont extrêmement longues.

Puis-je reconvertir le Markdown en HTML ?

Oui, avec l'outil de conversion Markdown vers HTML. Les deux se complètent : le Markdown produit ici peut y être retransformé en HTML.

Mon HTML est-il envoyé sur un serveur ?

Non. La bibliothèque de conversion tourne dans votre navigateur ; le code collé n'est envoyé à aucun serveur.