HTML naar Markdown

Hoe het werkt

Markdown is wat README-bestanden, issuetrackers, wiki's en statische sites willen. HTML krijg je als je kopieert van een webpagina of exporteert uit een cms. Met de hand tussen die twee converteren is saai en het resultaat zit meestal vol overgebleven opmaakcode.

Wat netjes wordt geconverteerd

Koppen, alinea's, vet en cursief, links, afbeeldingen, inline code, codeblokken, citaten, horizontale lijnen en beide soorten lijsten, ook geneste. Deze hebben exacte Markdown-equivalenten en komen eruit zoals je ze met de hand zou schrijven.

Wat niet behouden kan blijven

Markdown kan geen opmaak, klassen, layout-divs, spans of iets visueels uitdrukken. Die tags worden uitgepakt: de tekst blijft behouden en de tag zelf wordt weggegooid, en het aantal wordt gemeld zodat je weet dat er iets is vereenvoudigd. Scripts en stijlblokken worden volledig verwijderd.

Tabellen

De tekst van tabellen blijft behouden, maar wordt niet weergegeven als Markdown-tabel, omdat HTML-tabellen vaak samengevoegde cellen en nesting gebruiken die de tabelsyntaxis van Markdown echt niet kan weergeven. Eenvoudige tabellen zijn sneller met de hand opnieuw op te maken dan dat ze worden verminkt.

Geparseerd, niet op patroon gezocht

De HTML wordt geparseerd door de eigen parser van je browser en niet met reguliere expressies verwerkt, zodat onjuiste en diep geneste opmaak wordt behandeld zoals een browser dat zou doen.