Цей конвертер Markdown в AsciiDoc переписує текст синтаксисом Asciidoctor: назва документа, розділи ==, блоки [source,lang], таблиці |===, блоки-примітки NOTE і WARNING та виноски. Вставте Markdown і скопіюйте текст .adoc.
Оновлено:
Як це працює
Вставте Markdown
Вставте документацію, відкрийте файл .md або натисніть «Відкрити приклад».
Налаштуйте заголовок документа
Зробіть перший H1 назвою документа, додайте :toc:, залиште або приберіть вбудований HTML.
Збережіть як .adoc
Завантажте файл для Asciidoctor, Antora або GitHub, який теж відображає файли .adoc.
Можливості
Відповідні admonitions
Сповіщення GitHub переходять один в один: [!TIP] стає блоком [TIP], [!CAUTION] — блоком [CAUTION].
Списки з вмістом
Блоки коду всередині пунктів списку приєднуються продовженнями списку +, тому нумерація не збивається.
Таблиці з вирівнюванням
Вирівнювання стовпців і рядок заголовків записуються в рядку [cols="<,^,>",options="header"].
Обмежене й необмежене форматування
Жирний шрифт чи курсив поруч із літерами записується **подвійними** символами, як вимагає AsciiDoc усередині слів.
Обмеження та конфіденційність
Розмір файлу — до 10 MB. Тексти, більші за 256 KB, конвертуються у фоновому потоці (Web Worker), тому сторінка не зависає. Нічого не надсилається на сервер: усе обробляється в браузері, а «Відкрити за URL» отримує файл безпосередньо з указаної адреси. Докладніше — на сторінці конфіденційності.
Варто знати
Текст, з якого почалося б форматування AsciiDoc (* _ ` # ^ ~, посилання на атрибути {attribute}, типографські заміни на кшталт (C)), екранується. Вбудований HTML зберігається як блок passthrough, якщо ви його не прибрали; passthrough працює лише з HTML-бекендом.
Часті запитання
Як конвертувати Markdown в AsciiDoc?
Вставте Markdown і скопіюйте результат або завантажте його як файл .adoc.
Чому перший заголовок стає = Title?
В AsciiDoc заголовок рівня 0 — це назва документа. Вимкніть параметр «Перший H1 — назва документа», щоб усі заголовки лишилися розділами.
Чи підтримуються виноски?
Так. Вони стають вбудованими макросами footnote:[…] у місці посилання.
А що з формулами?
Формули стають latexmath:[…] і блоками [latexmath]; увімкніть атрибут stem у налаштуваннях Asciidoctor.
Чи можна повернутися до Markdown?
Так, посилання на AsciiDoc → Markdown є над результатом.
Чи надсилається документ на сервер?
Ні. Конвертація безкоштовна, без реєстрації й повністю виконується у вашому браузері.