Convertisseur HTML ↔ Markdown

La migration de contenu entre plateformes est l'une des tâches les plus redoutées des équipes techniques. Passer de WordPress à Notion, de Confluence à GitHub Wiki ou d'un CMS propriétaire à un site statique (Hugo, Gatsby, Next.js) implique de convertir des centaines de pages HTML en Markdown, ou inversement. Et c'est là que les choses se compliquent.

Pourquoi les conversions cassent vos tableaux

Les tableaux HTML utilisent des balises imbriquées (table, thead, tbody, tr, th, td) avec des attributs de style et de structure. Le Markdown standard ne supporte pas les tableaux. C'est l'extension GFM (GitHub Flavored Markdown) qui ajoute une syntaxe de tableaux avec des pipes et des tirets.

Le problème survient quand un tableau HTML contient des cellules fusionnées (colspan, rowspan), du HTML inline (gras, liens) ou des sauts de ligne dans une cellule. La plupart des convertisseurs en ligne échouent silencieusement sur ces cas et produisent un Markdown malformé. Notre outil utilise la bibliothèque Turndown (HTML → Markdown) et Showdown (Markdown → HTML) avec le support GFM activé pour gérer ces cas.

HTML → Markdown : les cas d'usage

La conversion HTML vers Markdown est nécessaire quand vous migrez un blog WordPress vers un générateur de site statique (Hugo, Gatsby, Next.js) qui utilise des fichiers Markdown. Elle est aussi utile pour convertir des emails HTML en documentation lisible, transformer des pages Confluence en fichiers GitHub Wiki, ou extraire du contenu propre depuis une page web pour le réutiliser dans un README.

Markdown → HTML : les cas d'usage

La conversion inverse est courante quand vous rédigez en Markdown (dans VS Code, Obsidian ou Notion) et devez publier en HTML dans un CMS, un email ou une page web. Elle est aussi utile pour générer des previews HTML de documentation technique ou créer des newsletters à partir de notes Markdown.

Les pièges de la conversion bidirectionnelle

Une conversion n'est jamais parfaitement réversible. Convertir du HTML en Markdown puis reconvertir en HTML ne produira pas le même HTML de départ. Les classes CSS sont perdues. Les attributs id et style disparaissent. Les commentaires HTML sont supprimés. C'est normal : le Markdown est un format simplifié qui ne porte pas d'information de style. Notre outil préserve la structure sémantique (titres, paragraphes, listes, tableaux, liens, images) mais ne conserve pas le formatage visuel.

Bonnes pratiques pour une migration réussie

Avant de convertir un volume important de pages, testez avec un échantillon représentatif qui inclut les cas les plus complexes (tableaux, listes imbriquées, blocs de code, images). Vérifiez la preview HTML après conversion pour détecter les pertes de structure. Pour les documents très longs (plus de 10 000 mots), traitez-les par sections pour faciliter la relecture.

Questions fréquentes

Les tableaux complexes sont-ils supportés ?

Notre outil supporte les tableaux GFM standard (lignes et colonnes simples). Les cellules fusionnées (colspan/rowspan) sont converties en cellules individuelles car le Markdown GFM ne supporte pas la fusion. Pour les tableaux très complexes, nous recommandons de conserver le HTML brut dans votre fichier Markdown.

Puis-je convertir un document WordPress complet ?

Oui. Exportez votre article WordPress en HTML (via l'éditeur classique ou en copiant le code source), collez-le dans notre outil et lancez la conversion. Les images seront conservées sous forme de balises Markdown avec les URLs originales. Vous devrez ajuster les chemins d'images si vous changez d'hébergement.

Quelle est la limite de taille ?

Notre outil fonctionne côté client (dans votre navigateur), il n'y a pas de limite serveur. Cependant, les documents très longs (plus de 50 000 caractères) peuvent ralentir la preview en temps réel. Dans ce cas, désactivez la preview pendant la saisie et lancez la conversion manuellement.