Przecena do Konwerter HTML
Przekształć tekst Markdown w gotowy do produkcji kod HTML dzięki obsłudze podglądu na żywo.
Przekształć tekst Markdown w gotowy do produkcji kod HTML dzięki obsłudze podglądu na żywo.
Markdown to lekki język znaczników stworzony przez Johna Grubera w 2004 roku, aby umożliwić autorom tworzenie ustrukturyzowanego kodu HTML przy użyciu konwencji zwykłego tekstu: znaki skrótu dla nagłówków, gwiazdki dla podkreślenia, łączniki dla list, wcięte bloki dla kodu. Format stał się domyślny dla plików README, dokumentacji technicznej, wersji roboczych blogów, generatorów witryn statycznych i każdego kontekstu, w którym tekst powinien być czytelny jako zwykły tekst i wyrenderowany wynik. Konwersja Markdown na HTML to krok renderowania, który zamienia źródło w stronę internetową.
Ten konwerter korzysta z oznaczonej biblioteki, najpopularniejszego modułu renderującego Markdown w JavaScript. Marked obsługuje CommonMark i GitHub Flavored Markdown (GFM), co oznacza, że tabele, chronione bloki kodu, listy zadań, przekreślenia i automatyczne łączenie działają poprawnie oprócz standardowych funkcji Markdown.
Dane wyjściowe to zwykły kod HTML — znaczniki semantyczne dla nagłówków, akapitów, list, łączy i obrazów oraz zaczepy klas dla bloków kodu tam, gdzie oczekują ich narzędzia do podświetlania składni. Wynik wklej bezpośrednio do dowolnego systemu CMS, osadź w generatorach stron statycznych lub służy jako samodzielny plik .html. Nie dodano żadnego CSS ani JavaScript; stylizowanie wyniku pozostawia się dalszemu kontekstowi.
Markdown to format preferowany przez autorów i programistów; HTML to format renderowany przez przeglądarki. Większość generatorów stron statycznych i platform CMS konwertuje Markdown na HTML za kulisami, ale czasami potrzebna jest konwersja jako samodzielny krok — wklejenie do CMS, który nie obsługuje Markdown, wygenerowanie HTML dla e-maili, utworzenie szybkiego podglądu lub wyodrębnienie wyrenderowanych danych wyjściowych do dalszego przetwarzania.
HTML jest także kanonicznym formatem wszelkich treści, które ostatecznie będą wyświetlane w przeglądarce. Biuletyny e-mailowe utworzone na podstawie wersji roboczych Markdown, strony dokumentacji osadzone w większych aplikacjach HTML i posty na blogach wklejane do redaktorów, którzy oczekują HTML, korzystają z czystej konwersji.
Wklej Markdown, pobierz HTML.
Marked wykorzystuje architekturę dwuprzebiegową. Lekser tokenizuje dane wejściowe w tokenach blokowych (nagłówki, akapity, listy, bloki kodu) i tokenach wbudowanych (podkreślenie, linki, obrazy). Analizator analizuje strumień tokenów i emituje kod HTML, stosując zaczepy modułu renderującego dla każdego typu tokena.
Rozszerzenia GitHub Flavored Markdown są domyślnie włączone: tabele (przy użyciu składni potokowej), chronione bloki kodu (potrójne znaczniki wsteczne ze wskazówkami językowymi), listy zadań (- [ ] i - [x]), przekreślenie (przy użyciu podwójnych tyld) i automatyczne łączenie adresów URL. Bloki kodu emitują wstępnie zawinięty kod z opcjonalną klasą języka w celu podświetlania składni.
Odkażanie wyjściowe pozostawia się dalszym konsumentom. Marked emituje wszystko, co wygeneruje dane wejściowe, w tym surowy kod HTML osadzony w Markdown. Jeśli akceptujesz niezaufane dane wejściowe, przed renderowaniem w przeglądarce uruchom dane wyjściowe za pomocą DOMPurify lub podobnego narzędzia do czyszczenia HTML.