Utilia
Kategorie ▾
Język: pl ▾

Konwerter HTML na Markdown

Konwertuj HTML na Markdown i Markdown na HTML w przeglądarce, z tabelami GitHub, przekreśleniami, listami zadań i bezpiecznym podglądem.

Kierunek konwersji

Podgląd

Podgląd jest oczyszczony: skrypty, formularze i procedury obsługi zdarzeń są usuwane, a zdalne obrazy nigdy nie są wczytywane.

Jak przekonwertować HTML na Markdown

  1. Wybierz kierunek: HTML → Markdown lub Markdown → HTML.
  2. Wklej kod w pole wejściowe albo kliknij Otwórz plik, aby wczytać z komputera plik .html, .htm, .md lub .txt (do 10 MB).
  3. Dostosuj opcje. Przy konwersji HTML → Markdown możesz wybrać styl Nagłówki, Znacznik listy i styl Bloki kodu. Przy konwersji Markdown → HTML opcja Oczyść HTML (usuń skrypty i procedury obsługi zdarzeń) jest domyślnie włączona.
  4. Kliknij Konwertuj. Wynik aktualizuje się także podczas pisania.
  5. Skopiuj lub pobierz wynik. Odwróć kierunek przenosi wynik z powrotem do pola wejściowego, dzięki czemu możesz przekonwertować go w drugą stronę i sprawdzić konwersję w obie strony.

Podgląd pod wynikiem pokazuje, jak wyrenderuje się Markdown, więc konwersję sprawdzisz jednym spojrzeniem.

Co robi konwersja HTML → Markdown

Konwerter odczytuje HTML wbudowanym parserem przeglądarki, w nieaktywnym dokumencie: skrypty się nie uruchamiają, a obrazy nie są pobierane. Następnie przechodzi przez strukturę strony i zapisuje odpowiednik każdego elementu w Markdown:

  • <h1> do <h6> stają się nagłówkami. ATX (# Tytuł) zapisuje od # do ######; Setext (podkreślone) podkreśla nagłówki poziomu 1 i 2 znakami === lub --- (poziomy 3–6 zawsze używają #).
  • <strong> i <b> stają się **pogrubieniem**, <em> i <i> – _kursywą_, a <code> w tekście – fragmentem w odwróconych apostrofach.
  • Linki stają się [tekst](url "tytuł"), a obrazy – ![alt](src).
  • Listy używają wybranego znacznika (-, * lub +); listy numerowane zachowują swój numer start, a listy zagnieżdżone są wcinane.
  • <pre><code> staje się blokiem kodu: Ogrodzone (```) lub Wcięte (4 spacje).
  • Konwertowane są też <blockquote>, <hr> i znaki nowego wiersza.
  • <script>, <style>, <iframe>, <noscript> i podobne elementy są usuwane razem z zawartością.

Znaki, które inaczej zostałyby odczytane jako składnia Markdown, np. * czy # na początku wiersza, są poprzedzane ukośnikiem wstecznym, aby tekst pozostał dosłowny.

GitHub Flavored Markdown

Z zaznaczoną opcją GitHub Flavored Markdown (tabele, ~~przekreślenie~~, listy zadań):

  • Tabele stają się tabelami z kreskami pionowymi i wyrównanymi kolumnami. Nagłówek pochodzi z wiersza <thead> lub z wiersza złożonego tylko z komórek <th>; jeśli takiego nie ma, dodawany jest pusty wiersz nagłówka, bo GFM go wymaga. Wyrównanie kolumn jest odczytywane z align="right" lub style="text-align: center". Kreski pionowe w komórkach są escapowane jako \|, znaki nowego wiersza stają się <br>, a colspan jest uzupełniany pustymi komórkami. <caption> jest zapisywany jako akapit nad tabelą.
  • <del>, <s> i <strike> stają się ~~przekreśleniem~~.
  • Pola wyboru na początku elementów listy stają się elementami listy zadań: - [x] zrobione, - [ ] do zrobienia.

Markdown nie ma odpowiednika dla zagnieżdżonych tabel, scalonych wierszy ani stylów komórek. Tabela zawierająca inną tabelę pozostaje surowym HTML, który akceptuje większość rendererów Markdown. Bez opcji GFM każda tabela pozostaje w HTML.

Markdown → HTML

W drugą stronę Markdown jest renderowany parserem zgodnym z CommonMark, z rozszerzeniami GFM, gdy opcja jest włączona. Wynikiem są fragmenty HTML gotowe do wklejenia do CMS-a, szablonu e-maila lub strony internetowej. Gdy zaznaczono Oczyść HTML (usuń skrypty i procedury obsługi zdarzeń), surowy HTML osadzony w Markdown jest czyszczony: usuwane są znaczniki <script>, atrybuty onclick i linki javascript:. Odznacz tę opcję tylko dla Markdown, który napisałeś sam.

Najczęściej zadawane pytania

Czy mój HTML jest wysyłany na serwer?

Nie. Obie konwersje działają w całości w twojej przeglądarce, a strona nigdy nie przesyła tego, co wklejasz lub otwierasz. Możesz bezpiecznie konwertować wewnętrzną dokumentację czy szkice.

Czy podgląd jest bezpieczny przy niezaufanym HTML?

Tak. Podgląd zawsze przechodzi przez DOMPurify: skrypty, formularze, ramki i procedury obsługi zdarzeń są usuwane, linki otwierają się w nowej karcie bez dostępu do tej strony, a zdalne obrazy nigdy nie są wczytywane. Wyświetlane są tylko obrazy osadzone jako adresy data:.

Dlaczego niektóre części mojej strony znikają?

Markdown opisuje wyłącznie strukturę treści. Elementy układu, klasy CSS, style inline, formularze i osadzone widżety nie mają postaci w Markdown, więc zachowywany jest tylko ich tekst. Skrypty i style są usuwane w całości.

Czy mogę przekonwertować całą stronę internetową?

Tak. Wklej pełne źródło, łącznie z <html> i <head>: konwertowana jest tylko zawartość <body>. Aby uzyskać czystszy Markdown, wklej sam artykuł zamiast nawigacji i stopki.

Jakiej odmiany Markdown używa wynik?

Wynik jest zgodny z CommonMark, standardem obsługiwanym przez GitHub, GitLab, Obsidian, większość generatorów stron statycznych i wiele edytorów CMS. Tabele, przekreślenia i listy zadań są zgodne ze specyfikacją GitHub Flavored Markdown.

Podobne narzędzia