Online konvertor AD do MD zdarma

Markdown se běžně vyžaduje pro soubory README, Git repositories, documentation sites a lightweight editing, zatímco některé zdrojové dokumenty přicházejí jako soubory AsciiDoc s kratší příponou .ad. Převod zachová jejich čitelný obsah a současně přizpůsobí nadpisy, seznamy, odkazy, bloky kódu a tabulky syntaxi Markdown.

Co je formát AD

V kategorii textových souborů označuje .ad běžně zdrojový soubor AsciiDoc. AsciiDoc je značkovací jazyk v prostém textu pro technickou dokumentaci, knihy, příručky, soubory README a webové stránky; stejný jazyk se častěji ukládá s příponou .adoc nebo .asciidoc.

Soubory AsciiDoc lze vytvářet pomocí původního procesoru AsciiDoc, Asciidoctor, textových editorů a systémů pro sestavování dokumentace. Obsahují čitelné zdrojové značky, například názvy sekcí, seznamy, odkazy, bloky zdrojového kódu, upozornění, tabulky, atributy a direktivy include. Samotná přípona není rozhodující, proto před převodem ověřte, že soubor obsahuje syntaxi AsciiDoc.

Co je formát MD

.md označuje soubor Markdown. Markdown používá znaky prostého textu pro nadpisy, zvýraznění, odkazy, seznamy, citace, bloky kódu a další strukturu dokumentu. Markdown běžně vykreslují GitHub, GitLab, generátory statických webů, aplikace pro psaní poznámek, platformy pro dokumentaci a editory kódu.

Markdown je užitečný, když musí dokument zůstat snadno čitelný i bez rendereru, dobře fungovat se správou verzí nebo být přijat jako soubor README či zdroj dokumentace. GitHub Flavored Markdown, běžně označovaný jako GFM, přidává tabulky, seznamy úkolů, přeškrtnutí a bloky kódu s ohraničením.

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

Pomocí Asciidoctor a Pandoc

Pro spolehlivý převod použijte Asciidoctor k interpretaci zdroje AsciiDoc a k vytvoření DocBook XML, poté pomocí Pandoc převeďte tento strukturovaný mezisoubor na Markdown GFM. Nainstalujte Asciidoctor a Pandoc, umístěte zdroj do pracovního adresáře a spusťte:

1. Převeďte soubor AsciiDoc na DocBook XML:
   asciidoctor -b docbook5 -o input.xml input.ad
2. Převeďte XML na Markdown:
   pandoc -f docbook -t gfm input.xml -o output.md
3. Otevřete output.md v editoru Markdown a zkontrolujte nadpisy, odkazy, tabulky, obrázky, seznamy a bloky kódu.

Pro jednorázový shell pipeline použijte:

asciidoctor -b docbook5 -o - input.ad | pandoc -f docbook -t gfm -o output.md

Pomocí vestavěného online převodníku

Soubor můžete zdarma převést na webu 101convert.com bez instalace softwaru: vyberte vstupní formát AD, nahrajte input.ad, zvolte MD jako výstupní formát, spusťte převod a stáhněte výsledný soubor .md.

Omezení kvality a kompatibility

Převod mění značky, nikoli pouze příponu souboru. Atributy AsciiDoc, podmíněný obsah, makra, křížové odkazy, vložené diagramy a složité struktury tabulek nebo upozornění mohou po převodu vyžadovat ruční úpravy.

Používejte cesty, které zůstanou platné vzhledem k umístění souboru Markdown. Odkazy na obrázky může být nutné opravit a role nebo atributy specifické pro AsciiDoc mohou být odstraněny, protože standardní Markdown pro ně nemá ekvivalent. Výstup GFM je obvykle nejkompatibilnější volbou pro GitHub a GitLab, zatímco základní Markdown je vhodnější, pokud cílové prostředí podporuje pouze původní syntaxi.

Direktivy include a substituce zdrojů v AsciiDoc mohou ovlivnit vygenerovaný výsledek. Po předzpracování výstup zkontrolujte, zejména když zdroj používá externí soubory, vlastní atributy nebo relativní cesty k obrázkům.