Zdarma převodník

Markdown to Převaděč HTML

Transformujte text Markdown do kódu HTML připraveného pro produkci s podporou živého náhledu.

O tomto nástroji

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.

Proč převést Markdown do HTML

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.

Jak používat

Vložte Markdown, získejte HTML.

  1. Přidejte svůj Markdown: Vložte text Markdown do vstupní oblasti nebo přetáhněte soubor .md. Fungují standardní syntaxe Markdown i GitHub Flavored Markdown.
  2. Převést: Marked analyzuje Markdown do AST a vydává HTML. Standardní vložené prvky (zvýraznění, silné, odkazy, kód, obrázky), blokové prvky (nadpisy, odstavce, seznamy, blokové uvozovky) a rozšíření GFM (tabulky, chráněný kód, seznamy úkolů, automatické odkazy) se všechny vykreslují správně.
  3. Náhled: Zkontrolujte vykreslený HTML v panelu náhledu. Potvrďte, že se bloky kódu, tabulky a další složité prvky zobrazují podle očekávání.
  4. Zkopírujte nebo stáhněte: Zkopírujte HTML do schránky pro vložení do CMS nebo uložte jako .html pro samostatné použití. Výstupem je sémantické HTML5 bez vložených stylů.

Běžné případy použití

Technické detaily

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.

Nejlepší postupy

Často kladené dotazy

Změní převod MARKDOWN do HTML obsah?
Obsah je zachován co nejpřesněji. Některé funkce specifické pro formát však nemusí mít přímé ekvivalenty, takže mohou nastat drobné rozdíly ve formátování.
K čemu se používá formát HTML?
HTML (HyperText Markup Language) se primárně používá pro webové stránky a webový obsah.
Existují nějaká omezení, která je třeba si uvědomit?
Podporovány jsou soubory do 50 MB. Zpracování velmi velkých nebo složitých souborů může trvat déle. Veškerá konverze probíhá ve vašem prohlížeči, takže rychlost zpracování závisí na vašem zařízení.
Je tato konverze bezpečná a soukromá?
Ano. Veškeré zpracování probíhá lokálně ve vašem prohlížeči. Vaše data nikdy neopustí vaše zařízení – žádné nahrávání na server, žádné cloudové zpracování, žádný sběr dat.
Jsou podporovány emotikony?
Emoji Unicode procházejí přímo (zadáním emodži srdce se ve výstupu zobrazí srdce). GitHub-style :emoji: krátké kódy se ve výchozím nastavení nepřevádějí; v případě potřeby přidejte rozšíření.
Je můj Markdown nahrán na server?
Ne. Označené běhy ve vašem prohlížeči; převod probíhá výhradně na vašem zařízení.
Mohu do HTML přidat vlastní styl?
Ano, po konverzi. Výstupem je prosté sémantické HTML; použít vlastní CSS na nadpisy stylů, bloky kódu, tabulky a další prvky.
Podporuje poznámky pod čarou?
Standardní CommonMark neurčuje syntaxi poznámky pod čarou. Některá rozšíření Markdown podporují syntaxi poznámky pod čarou [^1]; tento převodník se řídí GFM, který neobsahuje poznámky pod čarou.