# Конвертер Markdown ⇄ AsciiDoc

Двусторонняя конвертация между Markdown (диалект GitHub) и AsciiDoc (стандарт Antora, Red Hat и Asciidoctor): автоматический сдвиг уровней заголовков (= в AD — титул документа), разворот порядка скобок в ссылках, fenced-блоки ⇄ [source], GFM-таблицы ⇄ |===, admonition-блоки NOTE/TIP/WARNING, чек-листы, сноски, якоря и перекрёстные ссылки, жёсткие переносы; конструкции без точного эквивалента попадают в список предупреждений.

> Каноническая страница: https://elysiatools.com/ru/tools/markdown-asciidoc-converter

- **Категория:** Format Conversion

- **Ключевые слова:** markdown в asciidoc, asciidoc в markdown, миграция antora, конвертер asciidoctor, конвертация документации

## Обзор

Конвертер — построчный парсер блоков плюс токенизатор строчных выделений, без зависимостей, в обе стороны. Ключевые правила: MD #/## → AD ==/=== (кроме повышения первого H1 в титул =); [текст](url) разворачивается в url[текст], URL со скобками/подчёркиваниями оборачиваются в ++…++; fenced ``` → [source,lang] + ----; GFM-таблицы → |=== с options="header" и выравниванием :--- в colspec; цитаты > → блок [quote] с [quote, автор]; NOTE:/TIP:/IMPORTANT:/WARNING:/CAUTION: ⇄ GitHub-alert > [!NOTE]; чек-листы, сноски, [[якоря]], <<перекрёстные ссылки>>, жёсткие переносы и горизонтальные линии. Направление AD→MD деградирует include::, атрибуты {x} и условные директивы в HTML-комментарии с предупреждением. Round-trip без потерь не обещается — цель корректность однократной миграции.

## Входные данные

- **Направление конвертации** (select)
- **Исходный документ** (textarea): Paste your Markdown (or AsciiDoc when converting back)…
- **Повысить первый H1 до заголовка документа** (checkbox)
- **Оставлять видимой неразрешённую разметку** (checkbox)

## Когда использовать

- При миграции технической документации из репозиториев GitHub в генераторы статических сайтов на базе Antora или Asciidoctor.
- При адаптации файлов AsciiDoc для публикации в GitHub README, wiki-разделах и сервисах с поддержкой только Markdown.
- При необходимости быстро преобразовать таблицы с выравниванием, блоки кода и предупреждения (NOTE, WARNING) между двумя форматами разметки.

## Как это работает

- Выберите направление конвертации: Markdown в AsciiDoc (md2ad) или AsciiDoc в Markdown (ad2md).
- Вставьте исходный текст документа в поле ввода.
- Настройте параметры: повышение первого заголовка H1 до названия документа и сохранение неразрешенных конструкций в виде комментариев.
- Получите готовый результат конвертации со сгенерированной разметкой и списком замечаний.

## Сценарии использования

- Перенос руководств пользователя и документации API из репозиториев Markdown в структуру портала Antora.
- Преобразование страниц документации Asciidoctor в формат Markdown для публикации в GitHub Wiki и README.
- Пакетная конвертация changelog и release notes с таблицами, чек-листами и исходным кодом.

## Частые вопросы

### Как конвертер обрабатывает заголовки при переводе из Markdown в AsciiDoc?

При активной опции повышения первый заголовок H1 преобразуется в титул документа `=`, а последующие заголовки сдвигаются на соответствующие уровни `==`, `===`.

### Поддерживаются ли блоки предупреждений и примечаний (admonitions)?

Да, GitHub Alerts (`> [!NOTE]`, `> [!WARNING]`) и конструкции цитат трансформируются в блоки `NOTE:`, `WARNING:`, `TIP:` в AsciiDoc и обратно.

### Что происходит с директивами include:: и атрибутами AsciiDoc при конвертации в Markdown?

Конструкции, не имеющие прямого аналога в Markdown, сохраняются в виде HTML-комментариев с предупреждениями без потери исходного текста.

### Как переносятся таблицы с выравниванием столбцов?

GFM-таблицы преобразуются в блоки `|===` с указанием выравнивания в colspec, а таблицы AsciiDoc транслируются в стандартные pipe-таблицы Markdown.

### Изменяется ли порядок текста и адреса в ссылках?

Да, формат Markdown `[текст](url)` автоматически конвертируется в синтаксис AsciiDoc `url[текст]` с экранированием специальных символов в URL.

## Связанные инструменты

- [Markdown в HTML Конвертер](https://elysiatools.com/ru/tools/markdown-to-html): Конвертирует текст Markdown в HTML с настраиваемыми опциями форматирования
- [Markdown в обычный текст](https://elysiatools.com/ru/tools/markdown-to-plain-text): Преобразовать текст в формате Markdown в обычный текст, удалив весь синтаксис и форматирование Markdown
- [Карточка спеков Figma iOS Android pt dp sp (адаптивный дизайн)](https://elysiatools.com/ru/tools/figma-ios-android-pt-dp-sp-responsive-design-spec-card): Переводит px из Figma в правильные платформенные единицы и генерирует спеку для разработчиков: iOS pt (@1x/@2x/@3x с рендером px на каждый масштаб), Android dp/sp (таблица рендера mdpi…xxxhdpi и масштаб шрифта), web rem/vw со сниппетом clamp(); аудит минимальных сенсорных целей (44pt iOS / 48dp Android / 44px и 24px WCAG) с пометкой классов окон Material и брейкпоинтов Tailwind.
- [Сравнение хеш-алгоритмов](https://elysiatools.com/ru/tools/hash-algorithm-comparator): Хеширует один и тот же вход с помощью MD5, SHA-1, SHA-256, SHA-512, BLAKE2b и BLAKE3 и сравнивает их: длину, hex/Base64-дайджест, статус безопасности (взломан/современный) и относительный бенчмарк скорости. Полезно для обучения, выбора алгоритма и проверки контрольных сумм.
- [Декомпозиция дерева OKR и KPI](https://elysiatools.com/ru/tools/okr-tree-decomposer): Декомпозирует Objective компании в Отдел → Команда → Личное, с весом/целью/фактом по узлам; взвешенный прогресс поднимается наверх. Визуальное дерево + Markdown.
- [ИИ Изображение в Markdown](https://elysiatools.com/ru/tools/ai-image-to-markdown): Извлекать текст из изображений и конвертировать в формат markdown с использованием моделей ИИ-зрения
- [Калькулятор анионной разницы сыворотки (AG)](https://elysiatools.com/ru/tools/anion-gap-calculator): Рассчитывает анионную разницу сыворотки AG = Na⁺ − Cl⁻ − HCO₃⁻ (ммоль/л), с опцией формулы с K⁺ и коррекцией по альбумину. Повышенный AG (≈ >12) указывает на накопление неизмеренных анионов (лактат, кетоновые тела, метанол/этиленгликоль, салицилаты, почечная недостаточность; мнемоника GOLD-MARK). Метаболический ацидоз с нормальным AG (8–12) — гиперхлоремический: диарея, канальцевый ацидоз, инфузия солевых растворов. Низкий AG (<3–6) чаще из-за гипоальбуминемии; также гиперкальциемия/гипермагниемия, литий, миелома IgG (катионные парапротеины), бромид/псевдогиперхлоремия. При гипоальбуминемии используйте коррекцию AG_corr = AG + 2.5×(4.0 − альбумин). Источники: Kraut CJASN 2007, Figge 1998, MDCalc. Толковать с газами крови и клиникой. Не медицинская консультация.
- [Список с отступами в ASCII-дерево](https://elysiatools.com/ru/tools/ascii-tree-from-indented-list): Превращает иерархический список с отступами (2/4 пробела или таб; префиксы -, *, 1. опциональны) в копируемое ASCII-дерево каталогов. Два стиля: Unicode-рамка и классический ASCII. Переключатели: полные направляющие линии, хвостовые пробелы, листья в скобках.

## Примеры

- [Примеры Markdown](https://elysiatools.com/ru/samples/markdown-samples): Примеры формата Markdown от простых до сложных структур документов
- [Образцы просмотрщика Markdown](https://elysiatools.com/ru/samples/markdown-viewer-samples): Markdown-образцы для предпросмотра README, рендеринга документации и тестов разметки
- [Примеры Markdown Презентаций](https://elysiatools.com/ru/samples/md-slide-deck-to-pdf): Markdown колоды в стиле Remark/Marp для тестирования экспорта в PDF
- [PDF Примеры](https://elysiatools.com/ru/samples/pdf-samples): PDF примеры, созданные инструментами 2026-02-01..2026-02-10