Этот конвертер AsciiDoc в Markdown переводит документы Asciidoctor и Antora в GitHub Flavored Markdown: название и разделы, блоки исходного кода, таблицы, admonition-блоки, вложенные списки, сноски и ссылки на атрибуты. Вставьте текст .adoc и скопируйте Markdown.
Обновлено:
Как это работает
Вставьте AsciiDoc
Вставьте страницу .adoc, откройте файл или нажмите «Загрузить пример».
Настройте Markdown
Admonition-блоки как уведомления GitHub или цитаты, маркер списка, курсив и ограничитель кода.
Скопируйте Markdown
Используйте его на GitHub, в MkDocs, Docusaurus или Obsidian; вкладка «Просмотр» показывает результат.
Возможности
Подстановка атрибутов
Объявления вроде :product: Event Store подставляются во все ссылки {product} в тексте.
Блоки
Блоки listing, literal, quote, example, sidebar и passthrough, заголовки блоков (.Title) и атрибуты [source,lang].
Таблицы
Таблицы |=== с выравниванием из cols, строками заголовка (через параметр или пустую строку) и многострочными ячейками.
Списки
Вложенность через *, ** и . …, чек-листы, продолжение пункта (+) и списки определений (term::).
Ограничения и конфиденциальность
Файлы до 10 MB. Тексты больше 256 KB конвертируются в фоновом потоке (Web Worker). Ничего не загружается на сервер: конвертация идет в вашем браузере, а «Открыть по ссылке» скачивает файл напрямую с указанного адреса. Подробнее — на странице о конфиденциальности.
Ограничения
Условные директивы (ifdef, ifeval) не вычисляются. Объединенные по столбцам ячейки таблиц записываются как отдельные ячейки. Формулы AsciiMath остаются как есть, хотя рендереры Markdown ожидают TeX.
Частые вопросы
Как конвертировать .adoc в .md?
Вставьте AsciiDoc или откройте файл, затем скопируйте Markdown или скачайте его как файл .md.
Поддерживается ли include::?
Нет. Подключаемые файлы нельзя прочитать из браузера, поэтому директива пропускается с предупреждением.
Что происходит с заголовком документа?
= Title становится H1, строки с автором и ревизией удаляются, а атрибуты подставляются в текст.
Как конвертируются admonition-блоки?
Абзацы и блоки NOTE:, TIP:, IMPORTANT:, WARNING: и CAUTION: напрямую превращаются в уведомления GitHub.
Сохраняется ли кириллица в документах AsciiDoc?
Да. Конвертер меняет только разметку, русский текст переносится без изменений.
Можно ли конвертировать Markdown в AsciiDoc?
Да, с помощью конвертера Markdown → AsciiDoc — ссылка на него над результатом.