Konwerter HTML na Markdown
Zamień HTML w czysty, czytelny Markdown.
Działa w przeglądarce. Nic, co wpiszesz, nie jest nigdzie wysyłane.
- Zachowane nagłówki i listy
- Bloki kodu w ogrodzeniach
- Nic nie jest wysyłane
Jak zamienić HTML na Markdown
- Wklej swój HTML.
- Markdown pojawia się w trakcie pisania.
- Skopiuj albo pobierz plik Markdown.
Jak konwertują się elementy
| HTML | Markdown |
|---|---|
| <h2>Title</h2> | ## Title |
| <strong>bold</strong> | **bold** |
| <a href="...">text</a> | [text](...) |
| <code>x</code> | `x` |
| <pre><code>...</code></pre> | blok kodu w ogrodzeniu ``` |
Co nie konwertuje się czysto
- Tabele HTML przechodzą jako zwykły tekst, a nie składnia tabel Markdown.
- Style inline i klasy CSS są pomijane, bo Markdown nie ma dla nich odpowiednika.
- Divy układu i inny niestandardowy strukturalny HTML stają się zwykłymi akapitami.
- Powtórzone spacje i podziały wiersza użyte tylko dla wizualnego odstępu zwijają się do jednej spacji, tak samo jak przeglądarka normalnie traktuje nadmiarowe białe znaki HTML.
Gdzie używany jest skonwertowany Markdown
- Wklejanie strony internetowej do README albo wiki, które przyjmuje tylko Markdown.
- Podawanie oczyszczonej treści do generatora stron statycznych.
- Przenoszenie dokumentacji z eksportu CMS do narzędzia dokumentacji opartego na Markdown.
- Czyszczenie sformatowanego tekstu wklejonego z e-maila, zanim trafi do zwykłego tekstowego changeloga.
Styl wyjścia Markdown
- Nagłówki używają stylu # (ATX), a nie starszego stylu podkreślenia zapisywanego jako === albo ---.
- Bloki kodu używają ogrodzeń z potrójnym apostrofem wstecznym, a nie wcięcia 4 spacjami.
- Pogrubiony tekst używa **, a pochylony *, zgodnie z domyślnym stylem Turndown.
HTML na Markdown: najczęstsze pytania
Które elementy HTML dobrze się konwertują?
Nagłówki, akapity, listy, linki, obrazy, pogrubiony i pochylony tekst, cytaty blokowe i bloki kodu konwertują się czysto.
Czy tabele HTML są konwertowane?
Nie na składnię tabel Markdown. Tabele przechodzą jako swoja zawartość tekstowa, bo obsługa tabel w Markdown mocno się różni między narzędziami.
Czy mogę wkleić całą stronę internetową?
Tak. Wklej źródło HTML strony, a czytelna treść zamieni się w Markdown.
Jaka biblioteka za tym stoi?
Turndown, szeroko używany konwerter HTML na Markdown, ustawiony na nagłówki w stylu ATX (# Nagłówek) i bloki kodu w ogrodzeniach.
Czy to obsługuje zagnieżdżone listy?
Tak. Zagnieżdżone elementy <ul> i <ol> zamieniają się w wcięte pozycje listy Markdown, zachowując poziom zagnieżdżenia.
Czy to konwertuje encje HTML, jak & albo ?
Tak, popularne encje zamieniają się na zwykłe odpowiedniki znaków w wyniku Markdown, więc & staje się dosłownym & a zwykłą spacją.
Co się dzieje z cytatami blokowymi i liniami poziomymi?
<blockquote> staje się linią zaczynającą się od >, a <hr> linią trzech myślników, oba to standardowa składnia Markdown.
Czy mogę skonwertować HTML skopiowany prosto z Worda albo Dokumentów Google?
Tak, choć źródło często niesie dodatkowe znaczniki span i style inline do formatowania. Są one pomijane, bo Markdown nie ma odpowiednika, a widoczny tekst, nagłówki, linki i listy zostają nietknięte.