Convertir HTML en Markdown

Pourquoi convertir du HTML en Markdown

Le HTML est verbeux et pénible à éditer à la main, alors que le Markdown se lit presque comme du texte brut. Passer au Markdown facilite le suivi dans Git, l'édition dans des applis comme Obsidian ou la publication avec des générateurs de sites statiques comme Hugo, Jekyll, Astro et Docusaurus.

Ce convertisseur utilise Turndown, une bibliothèque éprouvée de conversion HTML vers Markdown, avec des réglages sensés : titres avec #, blocs de code délimités, puces en tiret et emphase avec astérisques. Il convertit aussi les tableaux au format GitHub et supprime scripts, styles et cadres intégrés : vous obtenez le contenu, pas la plomberie de la page.

HTML ou Markdown : comparaison rapide

Comment convertir du HTML en Markdown

1. 1

   Étape 1: Récupérez le fichier HTML

   Enregistrez une page web en .html, exportez un e-mail ou un article de CMS, ou placez un extrait dans un fichier .html.

2. 2

   Étape 2: Déposez-le dans le convertisseur

   Le fichier est analysé par le parseur HTML de votre navigateur.

3. 3

   Étape 3: Convertissez en Markdown

   L'en-tête, les scripts et les styles sont retirés, puis le body est converti élément par élément.

4. 4

   Étape 4: Téléchargez le fichier .md

   Ouvrez-le dans votre éditeur ou ajoutez-le à votre dépôt.

Ce qui est converti

Conversions HTML vers Markdown courantes

• Migrer un blog. Déplacez vos articles de WordPress ou d'un autre CMS vers un site basé sur le Markdown.

• Sauvegarder des articles dans vos notes. Conservez des copies lisibles de pages web dans Obsidian ou Logseq.

• Rédiger de la documentation. Transformez d'anciennes pages d'aide HTML en documentation versionnée.

• Préparer du texte pour l'IA. Le Markdown garde la structure tout en éliminant le bruit du HTML.

Ce qui est retiré ou simplifié

Le Markdown ne connaît ni mise en page, ni couleurs, ni classes : le style disparaît. Scripts, feuilles de style, blocs noscript, templates, iframes et tout le contenu du head sont entièrement supprimés. Les menus et pieds de page qui font partie du body apparaissent toujours ; pour une page web, vous voudrez peut-être les retirer ensuite.

Les tableaux complexes avec cellules fusionnées ne peuvent pas être représentés en tableaux à barres. Leur contenu est conservé cellule par cellule, mais la fusion est aplatie.

Liens et images

Les liens sont écrits sous la forme [texte](url) et les images sous la forme , avec les URL exactement telles qu'elles figurent dans le HTML. Les URL relatives comme /images/photo.jpg restent relatives et ne fonctionnent que si le Markdown vit dans un site à la même structure.

Les caractères qui ont un sens en Markdown, comme les astérisques et les tirets bas dans le texte, sont échappés par une barre oblique inverse pour que le document s'affiche comme l'original.

• Les URL absolues fonctionnent partout.
• Les URL relatives exigent la même arborescence.
• Le texte alternatif est conservé pour l'accessibilité.

Conseils pour un Markdown propre

• Enregistrez seulement la partie article d'une page quand c'est possible ; le mode lecture du navigateur aide.
• Faites un rechercher-remplacer des restes de navigation après la conversion d'une page complète.
• Vérifiez les tableaux à cellules fusionnées et reconstruisez-les à la main si nécessaire.
• Utilisez plutôt HTML vers TXT si vous ne voulez que les mots, sans balisage.

Questions sur la conversion HTML en Markdown