HTML en Markdown

Comment ça marche

Markdown est le format qu'attendent les fichiers README, les gestionnaires de tickets, les wikis et les sites statiques. Le HTML, c'est ce que l'on obtient en copiant depuis une page web ou en exportant depuis un CMS. Passer de l'un à l'autre à la main est fastidieux et le résultat est généralement plein de balisage résiduel.

Ce qui se convertit proprement

Titres, paragraphes, gras et italique, liens, images, code en ligne, blocs de code, citations, filets horizontaux et les deux types de listes, y compris imbriquées. Ces éléments ont des équivalents Markdown exacts et ressortent comme vous les écririez à la main.

Ce qui ne peut pas être conservé

Markdown ne peut pas exprimer la mise en forme, les classes, les div de mise en page, les span ni rien de visuel. Ces balises sont retirées : leur texte est conservé et la balise elle-même supprimée, et leur nombre est indiqué pour que vous sachiez que quelque chose a été simplifié. Les scripts et les blocs de style sont entièrement supprimés.

Tableaux

Le texte des tableaux est conservé mais n'est pas converti en tableau Markdown, car les tableaux HTML utilisent fréquemment des cellules fusionnées et des imbrications que la syntaxe de tableau de Markdown ne peut vraiment pas représenter. Il est plus rapide de remettre en forme à la main un tableau simple que de le voir abîmé.

Analysé, pas deviné par motifs

Le HTML est analysé par l'analyseur de votre navigateur plutôt que traité avec des expressions régulières, de sorte que le balisage mal formé ou profondément imbriqué est géré comme le ferait un navigateur.