HTML na Markdown

Jak to działa

Markdown jest tym, czego oczekują pliki README, systemy zgłoszeń, wiki i statyczne strony. HTML dostajesz, gdy kopiujesz ze strony internetowej lub eksportujesz z CMS-a. Konwertowanie między nimi ręcznie jest żmudne, a wynik zwykle jest pełen pozostałych znaczników.

Co konwertuje się czysto

Nagłówki, akapity, pogrubienie i kursywa, linki, obrazy, kod w tekście, bloki kodu, cytaty, linie poziome i oba rodzaje list, także zagnieżdżone. Mają one dokładne odpowiedniki w Markdown i wychodzą tak, jak napisałbyś je ręcznie.

Co nie przetrwa

Markdown nie ma sposobu na wyrażenie stylów, klas, układających strukturę elementów div, elementów span ani niczego wizualnego. Te znaczniki są zdejmowane — ich tekst zostaje, a sam znacznik jest odrzucany — a ich liczba jest podawana, byś wiedział, że coś zostało uproszczone. Skrypty i bloki stylów są usuwane w całości.

Tabele

Tekst z tabel jest zachowywany, ale nie jest przedstawiany jako tabela Markdown, ponieważ tabele HTML często używają scalonych komórek i zagnieżdżeń, których składnia tabel Markdown naprawdę nie potrafi odwzorować. Proste tabele szybciej oznaczyć ponownie ręcznie, niż pozwolić, by zostały zniekształcone.

Analizowany parserem, a nie dopasowywany wzorcami

HTML jest analizowany przez parser twojej przeglądarki, a nie przetwarzany wyrażeniami regularnymi, więc niepoprawne i głęboko zagnieżdżone znaczniki są obsługiwane tak, jak obsłużyłaby je przeglądarka.