Цей конвертер AsciiDoc у Markdown перетворює документи AsciiDoc (Asciidoctor, Antora) на GitHub Flavored Markdown: назву й розділи, блоки коду, таблиці, admonitions, вкладені списки, виноски та посилання на атрибути. Вставте текст .adoc і скопіюйте Markdown.
Оновлено:
Як це працює
Вставте AsciiDoc
Вставте сторінку .adoc, відкрийте файл або почніть із кнопки «Відкрити приклад».
Виберіть стиль Markdown
Admonitions як «Сповіщення 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). Нічого не надсилається на сервер: конвертація відбувається у вашому браузері, а «Відкрити за URL» отримує файл безпосередньо з указаної адреси. Докладніше — на сторінці конфіденційності.
Обмеження
Умовні директиви (ifdef, ifeval) не обчислюються. Об’єднані стовпці в таблицях записуються окремими клітинками. Формули AsciiMath лишаються як є, хоча рендерери Markdown очікують TeX.
Часті запитання
Як конвертувати .adoc у .md?
Вставте AsciiDoc або відкрийте файл, а потім скопіюйте Markdown чи завантажте його як файл .md.
Чи підтримується include::?
Ні. Браузер не може прочитати файли, які включаються, тому директива пропускається з попередженням.
Що відбувається із заголовком документа?
= Назва стає H1, рядки автора й ревізії відкидаються, а атрибути застосовуються.
Як конвертуються admonitions?
Абзаци й блоки NOTE:, TIP:, IMPORTANT:, WARNING: і CAUTION: напряму стають сповіщеннями GitHub.
Чи можна конвертувати Markdown в AsciiDoc?
Так, за допомогою інструмента «Markdown → AsciiDoc» — посилання на нього є над результатом.