Markdown to Převaděč HTML
Transformujte text Markdown do kódu HTML připraveného pro produkci s podporou živého náhledu.
Transformujte text Markdown do kódu HTML připraveného pro produkci s podporou živého náhledu.
Markdown je lehký značkovací jazyk, který vytvořil John Gruber v roce 2004, aby umožnil autorům vytvářet strukturované HTML pomocí konvencí prostého textu: hash znaky pro nadpisy, hvězdičky pro zvýraznění, pomlčky pro seznamy, odsazené bloky pro kód. Formát se stal výchozím pro soubory README, technickou dokumentaci, koncepty blogu, generátory statických stránek a jakýkoli kontext, kde by měl být text čitelný jako prostý text a jako vykreslený výstup. Převod Markdown do HTML je krok vykreslování, který změní zdroj na webovou stránku.
Tento konvertor používá označenou knihovnu, nejrozšířenější vykreslovací modul Markdown v JavaScriptu. Marked podporuje CommonMark a GitHub Flavored Markdown (GFM), což znamená, že tabulky, chráněné bloky kódu, seznamy úkolů, přeškrtnutí a automatické propojování všechny fungují správně kromě standardních funkcí Markdown.
Výstupem je prosté HTML – sémantické značky pro nadpisy, odstavce, seznamy, odkazy a obrázky plus háčky tříd pro bloky kódu tam, kde je nástroje pro zvýrazňování syntaxe očekávají. Výstup se čistě vloží do libovolného CMS, vloží se do generátorů statických stránek nebo slouží jako samostatný .html. Není přidán žádný CSS nebo JavaScript; stylování výsledku je ponecháno na vašem následném kontextu.
Markdown je formát, který autoři a vývojáři preferují; HTML je formát, který vykreslují prohlížeče. Většina generátorů statických stránek a platforem CMS převádí Markdown do HTML za scénou, ale někdy potřebujete převod jako samostatný krok – vložení do CMS, který nepodporuje Markdown, generování HTML pro e-maily, vytváření rychlého náhledu nebo extrahování vykresleného výstupu pro další zpracování.
HTML je také kanonický formát pro jakýkoli obsah, který se nakonec zobrazí v prohlížeči. E-mailové zpravodaje vytvořené z návrhů Markdown, stránek s dokumentací vložených do větších HTML aplikací a blogových příspěvků vložených do editorů, které očekávají HTML, těží z čisté konverze.
Vložte Markdown, získejte HTML.
Marked používá dvouprůchodovou architekturu. Lexer tokenizuje vstup na tokeny na úrovni bloku (nadpisy, odstavce, seznamy, bloky kódu) a vložené tokeny (zvýraznění, odkazy, obrázky). Analyzátor prochází proudem tokenů a vysílá HTML, přičemž pro každý typ tokenu aplikuje háčky vykreslování.
Rozšíření GitHub Flavored Markdown jsou ve výchozím nastavení povolena: tabulky (pomocí syntaxe potrubí), chráněné bloky kódu (trojité zpětné zaškrtnutí s nápovědou k jazyku), seznamy úkolů (- [ ] a - [x]), přeškrtnutí (pomocí dvojitých vlnovek) a automatické spojování adres URL. Bloky kódu vydávají předem zabalený kód s volitelnou jazykovou třídou pro zvýraznění syntaxe.
Dezinfekce výstupu je ponechána na následných spotřebitelích. Marked vydává vše, co vstup produkuje, včetně surového HTML vloženého do Markdown. Pokud přijmete nedůvěryhodný vstup, spusťte výstup před vykreslením v prohlížeči pomocí DOMPurify nebo podobného nástroje HTML.