Utilia
Kategorie ▾
Jazyk: cs ▾

Převodník HTML na Markdown

Převáděj HTML na Markdown a Markdown na HTML v prohlížeči, s tabulkami GitHubu, přeškrtnutím, seznamy úkolů a bezpečným náhledem. Nic se nenahrává.

Převod

Náhled

Náhled je vyčištěný: skripty, formuláře a obsluhy událostí se odstraní a vzdálené obrázky se nikdy nenačítají.

Jak převést HTML na Markdown

  1. Zvol směr: HTML → Markdown nebo Markdown → HTML.
  2. Vlož kód do vstupního pole, nebo klikni na Otevřít soubor a načti ze svého počítače soubor .html, .htm, .md či .txt (do 10 MB).
  3. Uprav možnosti. U převodu HTML → Markdown můžeš zvolit styl Nadpisů, Značku seznamu a styl Bloků kódu. U převodu Markdown → HTML je ve výchozím stavu zapnuto Vyčistit HTML (odstranit skripty a obsluhy událostí).
  4. Klikni na Převést. Výsledek se aktualizuje i při psaní.
  5. Výsledek zkopíruj nebo stáhni. Tlačítko Obrátit směr přesune výsledek zpět do vstupu, takže ho můžeš převést opačným směrem a zkontrolovat cestu tam a zpět.

Náhled pod výsledkem ukazuje, jak se Markdown vykresluje, takže převod zkontroluješ na první pohled.

Co dělá převod HTML → Markdown

Převodník čte tvé HTML vlastním parserem prohlížeče v neaktivním dokumentu: skripty se nespouštějí a obrázky se nestahují. Poté projde strukturu stránky a pro každý prvek zapíše odpovídající Markdown:

  • <h1> až <h6> se změní na nadpisy. ATX (# Nadpis) zapisuje # až ######, Setext (podtržené) podtrhuje nadpisy úrovně 1 a 2 pomocí === nebo --- (úrovně 3 až 6 vždy používají #).
  • <strong> a <b> se změní na **tučné**, <em> a <i> na _kurzívu_, řádkový <code> na zpětné apostrofy.
  • Odkazy se změní na [text](url "title") a obrázky na ![alt](src).
  • Seznamy používají zvolenou značku (-, * nebo +), číslované seznamy si zachovají počáteční číslo start a vnořené seznamy se odsazují.
  • <pre><code> se změní na blok kódu, buď Ohraničený (```), nebo Odsazený (4 mezery).
  • Převádějí se i <blockquote>, <hr> a konce řádků.
  • <script>, <style>, <iframe>, <noscript> a podobné prvky se odstraní i s obsahem.

Znaky, které by se jinak četly jako syntaxe Markdownu, například * nebo # na začátku řádku, se escapují zpětným lomítkem, aby text zůstal doslovný.

GitHub Flavored Markdown

Při zaškrtnutém GitHub Flavored Markdown (tabulky, ~~přeškrtnutí~~, seznamy úkolů):

  • Tabulky se změní na tabulky se svislítky se zarovnanými sloupci. Záhlaví se vezme z řádku <thead> nebo z řádku složeného jen z buněk <th>. Pokud žádné není, přidá se prázdný řádek záhlaví, protože ho GFM vyžaduje. Zarovnání sloupců se čte z align="right" nebo style="text-align: center". Svislítka uvnitř buněk se escapují jako \|, konce řádků se změní na <br> a colspan se doplní prázdnými buňkami. <caption> se zapíše jako odstavec nad tabulkou.
  • <del>, <s> a <strike> se změní na ~~přeškrtnutí~~.
  • Zaškrtávací pole na začátku položek seznamu se změní na položky seznamu úkolů: - [x] hotovo, - [ ] k udělání.

Markdown nemá ekvivalent pro vnořené tabulky, sloučené řádky ani stylování buněk. Tabulka, která obsahuje jinou tabulku, zůstane jako surové HTML, což většina vykreslovačů Markdownu přijímá. Bez volby GFM zůstává každá tabulka jako HTML.

Markdown → HTML

Opačným směrem se Markdown vykresluje parserem odpovídajícím specifikaci CommonMark, při zapnuté volbě i s rozšířeními GFM. Výstupem jsou úryvky HTML připravené k vložení do redakčního systému, šablony e-mailu nebo webové stránky. Při zaškrtnutém Vyčistit HTML (odstranit skripty a obsluhy událostí) se surové HTML vložené do Markdownu vyčistí: značky <script>, atributy onclick a odkazy javascript: se odstraní. Volbu vypni jen u Markdownu, který jsi napsal sám.

Časté dotazy

Odesílá se moje HTML na server?

Ne. Oba převody probíhají celé ve tvém prohlížeči a stránka nikdy nenahrává to, co vložíš nebo otevřeš. Můžeš bezpečně převádět interní dokumentaci nebo koncepty.

Je náhled bezpečný i s nedůvěryhodným HTML?

Ano. Náhled vždy prochází přes DOMPurify: skripty, formuláře, rámce a obsluhy událostí se odstraní, odkazy se otevírají na nové kartě bez přístupu k této stránce a vzdálené obrázky se nikdy nenačítají. Zobrazují se jen obrázky vložené jako adresy data:.

Proč některé části mé stránky mizí?

Markdown popisuje jen strukturu obsahu. Prvky rozvržení, třídy CSS, vložené styly, formuláře a vložené widgety nemají v Markdownu žádný tvar, takže se zachová jen jejich text. Skripty a styly se odstraní úplně.

Mohu převést celou webovou stránku?

Ano. Vlož celý zdrojový kód včetně <html> a <head>: převede se jen obsah <body>. Pro čistší Markdown vlož jen část s článkem, ne navigaci a patičku.

Jaký dialekt Markdownu výstup používá?

Výstup se řídí CommonMark, standardem podporovaným GitHubem, GitLabem, Obsidianem, většinou generátorů statických webů a mnoha editory redakčních systémů. Tabulky, přeškrtnutí a seznamy úkolů odpovídají specifikaci GitHub Flavored Markdown.

Související nástroje