01 / Postup
Jak to funguje
Načte zdokumentovanou podmnožinu vstupu a zapíše odpovídající výstupní reprezentaci.
Užitečná poznámka
U složité syntaxe nebo produkčních souborů ověřte výsledek v cílové aplikaci i specializovaným nástrojem.
Formátování kódu / MULTIVERTO
Převeďte podporované sémantické značky HTML na Markdown.
Každý textový nástroj použijte na předchozí výsledek.
01 / Postup
Načte zdokumentovanou podmnožinu vstupu a zapíše odpovídající výstupní reprezentaci.
U složité syntaxe nebo produkčních souborů ověřte výsledek v cílové aplikaci i specializovaným nástrojem.
02 / Příklad
<h1>Ahoj</h1><p>Vítej</p># Ahoj
Vítej03 / Postup
Převeďte podporované sémantické značky HTML na Markdown. Načte zdokumentovanou podmnožinu vstupu a zapíše odpovídající výstupní reprezentaci. Převádějí se pouze podporované sémantické značky HTML. Nadpisy, odstavce, zvýraznění, seznamy, odkazy a kód mají obdobu; styly a neznámé komponenty ne. Nepodporovaná značka vyvolá chybu místo tiché ztráty.
Markdown zahrnuje různá jednoduchá pravidla zápisu; CommonMark podrobně určuje jeho základ. Tento lokální převodník zvládá nadpisy, odstavce, nečíslované seznamy, bloky kódu, zvýraznění, vložený kód a základní webové odkazy. Surový HTML uvnitř Markdown se escapuje a nespouští. Opačný směr přijímá malou sadu sémantických značek HTML a neznámé elementy odmítá místo tiché ztráty obsahu. Složité tabulky, vnořené seznamy, obrázky, rozšíření a CSS zde nemají úplný obousměrný převod. Protože HTML umí vyjádřit vzhled a strukturu mimo možnosti Markdown, po převodu porovnejte vykreslení i původní text.
Změna datového formátu je mapování mezi dvěma modely informací, ne pouhá výměna interpunkce. Začněte malým reprezentativním záznamem, který podle potřeby obsahuje znak mimo ASCII, chybějící pole nebo vnořenou hodnotu. Spusťte převod a sledujte, jak se zapisují klíče, pořadí, čísla, null, pole a opakované položky. Cílový formát nemusí mít přímou obdobu některé vlastnosti zdroje; konkrétní návod popisuje podporované mapování. Výstup otevřete v cílové aplikaci a podle možnosti jej převeďte zpět k porovnání podstatných polí. Při hromadné migraci nebo externím kontraktu použijte úplný parser a testy schématu.
Původní zdroj si ponechte vedle výsledku a před velkým dokumentem vyzkoušejte krátký známý příklad. Porovnávejte významový obsah, nejen velikost souboru nebo počet řádků. Po transformaci zkontrolujte názvy, řetězce v uvozovkách, znaky mimo ASCII, konce řádků i opakovaná pole. Čitelný výsledek neověřuje schéma, nedokazuje spustitelnost kódu ani bezpečnost zveřejnění dat. Tato stránka zpracovává text v prohlížeči a ukazuje výsledek jako text, ale po vložení do jiné aplikace se uplatní její pravidla. Pokud nástroj vstup odmítne, najděte nepodporovanou konstrukci a podle potřeby použijte specializovaný parser. Při kopírování z dokumentace si všimněte typografických uvozovek, neviditelných mezer a značky pořadí bajtů na začátku textu. Tyto znaky mohou vypadat nenápadně, ale parser je může vyhodnotit jinak než běžnou mezeru nebo uvozovku.