DevToolPal
PL

Konwerter Markdown na HTML

Zamienia Markdown na HTML z GitHub Flavored Markdown, identyfikatorami nagłówków, opcjonalnym oczyszczaniem i pełną stroną.

Działa lokalnie, nic nie jest wysyłane

Opcje

Markdown

0 znaków · 0 B

HTML

0 znaków · 0 B

Co robi narzędzie

Konwerter Markdown na HTML zamienia tekst Markdown na znaczniki HTML, które możesz wkleić do CMS, szablonu e-maila, strony statycznej lub w dowolne miejsce, które przyjmuje HTML, ale nie Markdown. Przydaje się do publikowania README na stronie, przenoszenia notatek do edytora bloga albo sprawdzania, jakie dokładnie znaczniki daje fragment Markdownu.

Wynik to ten sam HTML, który generują popularne renderery Markdown: nagłówki od <h1> do <h6>, akapity <p>, listy <ul> i <ol>, bloki <pre><code> z klasą language- dla narzędzi do podświetlania składni oraz znaczniki <table> dla tabel w stylu GitHuba.

Jak używać

  1. Wpisz lub wklej Markdown, wgraj plik .md lub kliknij Przykład.
  2. Wybierz potrzebne opcje: GitHub Flavored Markdown, podziały wierszy jako <br>, identyfikatory nagłówków dla linków-kotwic, oczyszczanie dla niezaufanych danych oraz pełny dokument HTML zamiast fragmentu.
  3. Skopiuj HTML lub pobierz go jako plik .html.

Wynik aktualizuje się w trakcie pisania. Wyłącz opcję pełnego dokumentu, gdy wklejasz wynik do istniejącej strony, i włącz ją, gdy potrzebujesz samodzielnego pliku.

Przykład

Ten Markdown:

## Install

Run the **installer** and read the [guide](https://example.com).

- Windows
- macOS

zamienia się w taki HTML:

<h2>Install</h2>
<p>Run the <strong>installer</strong> and read the <a href="https://example.com">guide</a>.</p>
<ul>
<li>Windows</li>
<li>macOS</li>
</ul>

Wskazówki

  • Domyślnie surowy HTML w Markdownie zostaje bez zmian, tak jak w większości rendererów. Włączaj oczyszczanie zawsze, gdy Markdown napisał ktoś inny.
  • Z identyfikatorami nagłówków możesz linkować do sekcji adresem w rodzaju page.html#install i zbudować spis treści z nagłówków.
  • Bloki kodu zachowują język jako klasę, więc narzędzia takie jak Prism czy highlight.js rozpoznają je bez dodatkowej pracy.
  • Aby zobaczyć wyrenderowany wynik obok, użyj podglądu Markdown. W drugą stronę działa konwerter HTML na Markdown.

FAQ

› Jaka składnia Markdown jest obsługiwana?

Cały CommonMark, czyli nagłówki, wyróżnienia, linki, obrazy, listy, cytaty, kod i linie poziome. Po włączeniu GitHub Flavored Markdown dostajesz też tabele z wyrównaniem kolumn, listy zadań, przekreślenie i automatyczne linki dla gołych adresów URL.

› Co robi opcja oczyszczania?

Escapuje cały surowy HTML w Markdownie, aby wyświetlał się jako tekst zamiast stawać się znacznikami, i usuwa linki oraz obrazy, których URL używa niebezpiecznego schematu, takiego jak javascript lub vbscript. Włącz ją, gdy Markdown pochodzi od użytkowników, którym nie ufasz, na przykład z komentarzy lub forum.

› Jak powstają identyfikatory nagłówków?

Tak samo jak w GitHubie. Tekst nagłówka jest zamieniany na małe litery, interpunkcja jest usuwana, a spacje stają się łącznikami, więc Getting Started dostaje id getting-started. Powtórzone nagłówki dostają -1, -2 i tak dalej, dzięki czemu każda kotwica jest unikalna.

› Do czego służy opcja pełnego dokumentu HTML?

Opakowuje wynik w kompletną stronę z doctype, kodowaniem UTF-8, znacznikiem viewport, tytułem wziętym z pierwszego nagłówka pierwszego poziomu i małym, czytelnym arkuszem stylów. Zapisz ją jako plik .html, a otworzy się porządnie w każdej przeglądarce.

› Czy mój Markdown jest gdzieś wysyłany?

Nie. Konwersja działa w przeglądarce dzięki bibliotece marked i nic nie trafia na serwer.