Online konvertor ASCIIDOC do MD zdarma

GitHub, GitLab a mnoho nástrojů pro dokumentaci podporuje Markdown, ale ne AsciiDoc, takže soubor .adoc může před publikováním nebo úpravami v těchto nástrojích vyžadovat převod. Převod do .md zachová čitelný zdrojový kód a zároveň přizpůsobí nadpisy, seznamy, odkazy a bloky kódu syntaxi Markdownu.

Co je formát ASCIIDOC

AsciiDoc je formát značkování v prostém textu používaný pro softwarovou dokumentaci, příručky, knihy, poznámky k vydání a soubory README. Mezi běžné přípony patří .adoc, .asciidoc a .ad.

Soubory AsciiDoc se běžně vytvářejí nebo zpracovávají pomocí Asciidoctor, moderní implementace v Ruby, nebo staršího procesoru AsciiDoc. Tyto soubory mohou vytvářet také editory jako Visual Studio Code, IntelliJ IDEA a specializované nástroje pro dokumentaci, protože zdrojový kód je obyčejný text.

AsciiDoc podporuje atributy, direktivy include, bloky s upozorněními, tabulky, křížové odkazy, diagramy, citace a opakovaně použitelné struktury dokumentů. Některé z těchto funkcí nemají v Markdownu přímý ekvivalent.

Co je formát MD

MD je obvyklá přípona souborů Markdown. Markdown je odlehčený prostý text navržený pro čitelný zdrojový kód a snadné vykreslení do HTML. Běžně jej podporují GitHub, GitLab, Bitbucket, generátory statických webů, wiki, aplikace pro psaní poznámek a editory kódu.

Markdown je praktickou cílovou volbou, když úložiště vyžaduje soubor README.md, když spolupracovníci upravují dokumentaci v nástrojích zaměřených na Markdown nebo když je třeba zdrojové soubory zobrazovat konzistentně napříč platformami pro hostování kódu. GitHub Flavored Markdown (GFM) přidává tabulky, seznamy úkolů, automatické odkazy a bloky kódu ohraničené zpětnými apostrofy.

Jak skutečně převést ASCIIDOC na MD

Pro místní převod nainstalujte Pandoc a poté spusťte:

pandoc input.adoc -f asciidoc -t gfm -o output.md

Nahraďte input.adoc názvem zdrojového souboru a output.md požadovaným cílovým souborem. Volba -f asciidoc vybere čtečku AsciiDoc, -t gfm vytvoří GitHub Flavored Markdown a -o zapíše výsledek do souboru.

Chcete-li převést soubor s příponou .asciidoc, použijte jeho skutečný název:

pandoc manual.asciidoc -f asciidoc -t gfm -o manual.md

Pokud nainstalovaná verze Pandoc neposkytuje čtečku AsciiDoc, použijte Asciidoctor k vytvoření DocBook XML a poté tento mezisoubor převeďte:

asciidoctor -b docbook5 -o intermediate.xml input.adoc
pandoc intermediate.xml -f docbook -t gfm -o output.md

Pokud nechcete nic instalovat, nahrajte zdrojový soubor na 101convert.com, jako výstupní formát zvolte Markdown, spusťte převod a stáhněte výsledný soubor .md. Vyhněte se nahrávání dokumentů obsahujících důvěrné nebo neveřejné informace.

Omezení kvality a kompatibility

Převod není vždy bezeztrátový. Atributy AsciiDoc, podmíněný obsah, direktivy include, vlastní role, makra, rozšíření, komplexní tabulky, bloky s upozorněními a křížové odkazy mohou být zjednodušeny, vynechány nebo vygenerovány jako nezpracované značky.

Zkontrolujte vygenerovaný Markdown, zejména úrovně nadpisů, vnoření seznamů, formátování tabulek, cesty k obrázkům, ohraničení bloků kódu, odkazy a escapované znaky. GFM podporuje tabulky a seznamy úkolů, ale jiné parsery Markdownu mohou tyto funkce vykreslovat odlišně.

Direktivy include v AsciiDoc mohou před převodem vyžadovat předzpracování. Vyřešte soubory odkazované direktivami include:: a ověřte, že relativní cesty k obrázkům a odkazům stále směřují na správná umístění po přesunutí výstupního souboru.