Konwerter Markdown na HTML
Działa w całości w Twojej przeglądarce. Twoje pliki i dane nigdy nie opuszczają Twojego urządzenia.
O tym narzędziu
Wklej Markdown, a narzędzie zamieni go na HTML, albo wklej HTML, a wróci jako Markdown. Wybierz kierunek, którego potrzebujesz, a wynik będzie się aktualizował na bieżąco podczas pisania.
Jak działa konwersja?
Zamiana Markdown na HTML opiera się na bibliotece marked, z domyślnie włączonym wsparciem dla GitHub Flavored Markdown, czyli tabelami, przekreśleniami i listami zadań. Surowy HTML generowany przez marked wychodzi jako jeden znacznik na wiersz, więc narzędzie przepuszcza go potem przez wspólny formater HTML, który wcina zagnieżdżony kod, taki jak listy, tabele i cytaty. Dzięki temu wynik faktycznie wygląda jak sformatowany kod, a nie ściana płaskich znaczników.
Zamiana HTML na Markdown opiera się na turndown, skonfigurowanym pod nagłówki w stylu ATX (#, ##) i bloki kodu w ogrodzeniach. Turndown analizuje HTML własnym parserem zamiast prawdziwego DOM-u przeglądarki, więc toleruje zepsuty kod: niezamknięte znaczniki, niepoprawne zagnieżdżenie i inne błędy HTML są interpretowane najlepiej jak się da, zamiast wywoływać błąd. Dzięki temu narzędzie dobrze radzi sobie z HTML-em skopiowanym z żywej strony internetowej, który rzadko bywa tak czysty jak ręcznie pisany Markdown.
Czy moja treść jest gdzieś wysyłana?
Nie. Obie konwersje odbywają się w całości w przeglądarce, dzięki bibliotekom JavaScript dołączonym do strony; nic, co wklejasz, nie trafia na serwer ani nigdzie nie jest zapisywane. Ma to znaczenie, jeśli konwertujesz nieopublikowany szkic README, wewnętrzny dokument albo HTML zeskrobany ze strony, w którym wciąż są prawdziwe nazwiska czy dane konta. Puste pole wejściowe daje po prostu puste wyjście w obu kierunkach, więc nie ma czego sprzątać, zanim zaczniesz.
Do czego to się przydaje?
Typowe zastosowania to zamiana szkicu README na HTML do podglądu, konwersja wklejonego fragmentu strony na czysty Markdown do wiki albo aplikacji na notatki, albo sprawdzenie, jak wyrenderuje się tabela GFM, zanim trafi do repozytorium. Sprawdza się też dobrze do usuwania formatowania z szablonów e-maili HTML czy eksportów z CMS-a, bo Turndown sprowadza większość stylów w linii do prostych odpowiedników w Markdown.
Podstawową składnię Markdown znajdziesz w specyfikacji CommonMark, referencję HTML na MDN dla drugiego kierunku, a rozszerzenia dla tabel, przekreśleń i list zadań opisuje specyfikacja GFM od GitHuba.