Ten konwerter przepisuje Markdown na AsciiDoc w składni Asciidoctor: tytuł dokumentu, sekcje ==, bloki [source,lang], tabele |===, bloki uwag NOTE i WARNING oraz przypisy. Wystarczy wkleić Markdown i skopiować tekst .adoc.
Ostatnia aktualizacja:
Jak to działa
Wklej dokumentację
Rozdział podręcznika, stronę z dokumentacją API czy zwykłe README wystarczy wkleić, otworzyć jako plik .md lub wczytać przykład.
Dopasuj nagłówek dokumentu
„Pierwszy H1 jako tytuł” robi z pierwszego nagłówka tytuł dokumentu, „Spis treści” dodaje atrybut :toc:, a „Surowy HTML” decyduje, czy HTML zostaje, czy znika.
Zapisz jako .adoc
Plik można pobrać dla Asciidoctor, Antora lub GitHuba, który także renderuje pliki .adoc.
Funkcje
Uwagi jeden do jednego
Alerty GitHub mają swoje odpowiedniki: [!TIP] staje się blokiem [TIP], a [!CAUTION] blokiem [CAUTION].
Listy z zawartością
Bloki kodu w elementach listy są dołączane znakiem + (kontynuacja listy), więc numeracja się nie przerywa.
Tabele z wyrównaniem
Wyrównanie kolumn i wiersz nagłówka trafiają do wiersza [cols=…] z opcją header (opcja „Atrybuty tabel”).
Formatowanie w środku słowa
Pogrubienie lub kursywa przylegająca do liter dostaje **podwójne** znaczniki, bez których AsciiDoc nie sformatuje fragmentu wyrazu.
Limity i prywatność
Pliki do 10 MB. Teksty większe niż 256 KB są konwertowane w wątku roboczym w tle (Web Worker), więc strona przez cały czas reaguje. Nic nie jest wysyłane na serwer: konwersja odbywa się w przeglądarce, a „Otwórz z adresu URL” pobiera plik bezpośrednio z podanego adresu. Więcej na stronie o prywatności.
Dobrze wiedzieć
Tekst, który mógłby uruchomić formatowanie AsciiDoc – znaki * _ ` # ^ ~, odwołania do atrybutów w nawiasach klamrowych czy zamiany typograficzne w rodzaju (C) – jest odpowiednio chroniony. Surowy HTML zostaje w bloku passthrough, chyba że w opcji „Surowy HTML” wybierzesz „Usuń”. Pamiętaj, że passthrough działa tylko z backendem HTML.
Jeśli dokumentacja wraca do Markdownu, przyda się AsciiDoc → Markdown.
Najczęstsze pytania
Jak przekonwertować Markdown na AsciiDoc?
Wystarczy wkleić Markdown i skopiować wynik albo pobrać go jako plik .adoc.
Dlaczego pierwszy nagłówek zmienia się w = Tytuł?
W AsciiDoc nagłówek poziomu 0 to tytuł dokumentu. Po wyłączeniu opcji „Pierwszy H1 jako tytuł” wszystkie nagłówki zostają sekcjami.
Czy przypisy są obsługiwane?
Tak. Stają się makrami footnote:[…] wstawionymi w miejscu odwołania.
Co z wzorami matematycznymi?
Formuły zamieniają się w latexmath:[…] i bloki [latexmath]; w konfiguracji Asciidoctor trzeba włączyć atrybut stem.
Czy GitHub wyświetli plik .adoc zamiast README.md?
Tak, GitHub renderuje pliki .adoc, więc przekonwertowane README.adoc pokaże się na stronie repozytorium.
Czy można wrócić do Markdownu?
Tak, nad wynikiem jest link do konwertera AsciiDoc → Markdown.