Этот конвертер 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, поэтому страница не зависает. Ничего не загружается на сервер: конвертация идет в вашем браузере, а «Открыть по ссылке» скачивает файл напрямую с указанного адреса. Подробнее — на странице о конфиденциальности.
Полезно знать
Текст, который AsciiDoc принял бы за разметку (символы * _ ` # ^ ~, ссылки на атрибуты {attribute}, типографские замены вроде (C)), экранируется. HTML-вставки сохраняются блоком passthrough, если не выбрать «Удалить»; passthrough работает только с HTML-бэкендом.
Частые вопросы
Как конвертировать Markdown в AsciiDoc?
Вставьте Markdown и скопируйте результат или скачайте его как файл .adoc.
Почему первый заголовок превращается в = Title?
В AsciiDoc заголовок нулевого уровня — это название документа. Выключите «Первый H1 — заголовок документа», чтобы все заголовки остались разделами.
Поддерживаются ли сноски?
Да. Они становятся макросами footnote:[…] прямо в месте ссылки.
Что происходит с формулами?
Формулы становятся latexmath:[…] и блоками [latexmath]; в настройках Asciidoctor нужно включить атрибут stem.
Сохраняется ли русский текст?
Да, кириллица в тексте, заголовках и таблицах переносится без изменений — меняется только разметка.
Можно ли перевести AsciiDoc обратно в Markdown?
Да, ссылка на конвертер AsciiDoc → Markdown есть над результатом.