Konwerter AsciiDoc na Markdown przenosi dokumenty Asciidoctor i Antora do GitHub Flavored Markdown: tytuł i sekcje, bloki kodu źródłowego, tabele, bloki uwag, zagnieżdżone listy, przypisy i odwołania do atrybutów. Wystarczy wkleić tekst .adoc i skopiować wynik.
Ostatnia aktualizacja:
Jak to działa
Wklej AsciiDoc
Stronę .adoc można wkleić, otworzyć z dysku (także pliki .asciidoc i .asc) albo wypróbować narzędzie na przykładzie.
Wybierz styl wyniku
Bloki uwag jako alerty GitHub lub cytaty, punktor, wyróżnienie i znacznik bloku kodu.
Kopiuj lub pobierz
Markdown trafia na GitHuba, do MkDocs, Docusaurusa albo Obsidiana; podgląd pokazuje wynik jeszcze przed skopiowaniem.
Funkcje
Podstawione atrybuty
Wpisy atrybutów, np. :product: Event Store, są wstawiane w miejsca odwołań {product} w tekście.
Bloki
Bloki listing, literal, quote, example, sidebar i passthrough, tytuły bloków (.Tytuł) oraz atrybuty [source,lang].
Tabele
Tabele |=== z wyrównaniem z atrybutu cols, wierszem nagłówka (z opcji lub po pustej linii) i komórkami wielowierszowymi.
Listy
Zagnieżdżenia *, ** oraz . i .., listy kontrolne, kontynuacje elementów (+) i listy opisowe (termin::).
Limity i prywatność
Pliki do 10 MB; dane wejściowe większe niż 256 KB są konwertowane w wątku roboczym (Web Worker). Nic nie jest wysyłane na serwer: konwersja odbywa się w przeglądarce, a „Otwórz z adresu URL” pobiera plik bezpośrednio spod wpisanego adresu. Więcej na stronie o prywatności.
Ograniczenia
Warunki (ifdef, ifeval) nie są wyliczane. Komórki rozciągnięte na kilka kolumn są zapisywane jako osobne komórki. Wzory AsciiMath zostają bez zmian, choć renderery Markdownu oczekują TeX-a. Do przejścia w odwrotnym kierunku służy Markdown na AsciiDoc.
Najczęstsze pytania
Jak zamienić plik .adoc na .md?
Wystarczy wkleić AsciiDoc lub otworzyć plik, a potem skopiować Markdown albo pobrać go przyciskiem „Pobierz .MD”.
Czy include:: jest obsługiwane?
Nie. Przeglądarka nie ma dostępu do dołączanych plików, więc dyrektywa jest pomijana z ostrzeżeniem.
Co dzieje się z nagłówkiem dokumentu?
= Tytuł staje się nagłówkiem H1, linie z autorem i wersją są pomijane, a atrybuty zostają zastosowane w tekście.
Jak są konwertowane NOTE, TIP i WARNING?
Akapity i bloki NOTE:, TIP:, IMPORTANT:, WARNING: i CAUTION: przechodzą wprost w alerty GitHub.
Czy działa to także w drugą stronę?
Tak – konwerter Markdown na AsciiDoc jest podlinkowany nad wynikiem.