01 / Postup
Ako to funguje
Načíta zdokumentovanú podmnožinu vstupu a zapíše zodpovedajúcu výstupnú reprezentáciu.
Užitočná poznámka
Pri zložitej syntaxi alebo produkčných súboroch overte výsledok v cieľovej aplikácii aj špecializovaným nástrojom.
Formátovanie kódu / MULTIVERTO
Markdown na HTML
Vykreslite nadpisy, zoznamy a zvýraznenie Markdown ako HTML.
Okamžitý prevodVáš vstup zostáva v prehliadači. Text na prevod nikam neodosielame.
Súbor zostáva vo vašom prehliadači.
Reťaziť nástroje
Každý textový nástroj použite na predchádzajúci výsledok.
02 / Príklad
Príklad
Váš vstup
# Ahoj
Toto je **dôležité**.Výsledok
<h1>Ahoj</h1>
<p>Toto je <strong>dôležité</strong>.</p>03 / Postup
Markdown na HTML — Ako to funguje
Čo tento nástroj mení
Vykreslite nadpisy, zoznamy a zvýraznenie Markdown ako HTML. Načíta zdokumentovanú podmnožinu vstupu a zapíše zodpovedajúcu výstupnú reprezentáciu. Nadpisy, odseky, odrážky, zvýraznenie, bloky kódu a základné odkazy Markdown sa menia na HTML. Surový HTML vo vstupe sa escapuje. Pri rozšíreniach a vnorenej štruktúre porovnajte vykreslený článok.
Poznajte formát
Markdown zahŕňa rôzne jednoduché pravidlá zápisu; CommonMark podrobne určuje jeho základ. Tento lokálny prevodník zvláda nadpisy, odseky, nečíslované zoznamy, bloky kódu, zvýraznenie, vložený kód a základné webové odkazy. Surový HTML vo vnútri Markdown sa escapuje a nespúšťa. Opačný smer prijíma malú sadu sémantických značiek HTML a neznáme elementy odmieta namiesto tichej straty obsahu. Zložité tabuľky, vnorené zoznamy, obrázky, rozšírenia a CSS tu nemajú úplný obojsmerný prevod. Keďže HTML vie vyjadriť vzhľad a štruktúru mimo možností Markdown, po prevode porovnajte vykreslenie aj pôvodný text.
Spoľahlivý postup
Zmena dátového formátu je mapovanie medzi dvoma modelmi informácií, nie iba výmena interpunkcie. Začnite malým reprezentatívnym záznamom, ktorý podľa potreby obsahuje znak mimo ASCII, chýbajúce pole alebo vnorenú hodnotu. Spustite prevod a sledujte, ako sa zapisujú kľúče, poradie, čísla, null, polia a opakované položky. Cieľový formát nemusí mať priamu obdobu niektorej vlastnosti zdroja; konkrétny návod popisuje podporované mapovanie. Výstup otvorte v cieľovej aplikácii a podľa možnosti ho preveďte späť na porovnanie podstatných polí. Pri hromadnej migrácii alebo externom kontrakte použite úplný parser a testy schémy.
Overte výsledok
Pôvodný zdroj si nechajte vedľa výsledku a pred veľkým dokumentom vyskúšajte krátky známy príklad. Porovnávajte významový obsah, nielen veľkosť súboru či počet riadkov. Po transformácii skontrolujte názvy, reťazce v úvodzovkách, znaky mimo ASCII, konce riadkov aj opakované polia. Čitateľný výsledok neoveruje schému, nedokazuje spustiteľnosť kódu ani bezpečnosť zverejnenia dát. Táto stránka spracúva text v prehliadači a ukazuje výsledok ako text, ale po vložení do inej aplikácie sa uplatnia jej pravidlá. Ak nástroj vstup odmietne, nájdite nepodporovanú konštrukciu a podľa potreby použite špecializovaný parser. Pri kopírovaní z dokumentácie si všimnite typografické úvodzovky, neviditeľné medzery a znak poradia bajtov na začiatku textu. Tieto znaky môžu vyzerať nenápadne, no parser ich môže vyhodnotiť inak než obyčajnú medzeru alebo úvodzovku.
Markdown — Vstup
Načítať a zmeniť štruktúru
HTML — Výsledok