Как конвертер обрабатывает заголовки при переводе из 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.

Elysia Tools

Навигация

Format Conversion

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

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

Детали

С чем помогает этот инструмент

Конвертер — построчный парсер блоков плюс токенизатор строчных выделений, без зависимостей, в обе стороны. Ключевые правила: MD #/## → AD ==/=== (кроме повышения первого H1 в титул =); текст разворачивается в 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 без потерь не обещается — цель корректность однократной миграции.

Запуск

Запустить этот инструмент

Заполните форму, запустите инструмент и посмотрите результат на этой же странице.

Примеры

Примеры для этого инструмента

Связано

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

С чем помогает этот инструмент

Запустить этот инструмент

Примеры для этого инструмента

Продолжить с похожими инструментами и темами

Узнайте, когда использовать этот инструмент, что он поддерживает и как его применяют пользователи.

Ключевые факты

Обзор

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

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

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

Примеры

1. Перевод README проекта в документацию Antora

2. Конвертация руководства AsciiDoc в Markdown для GitHub Wiki

FAQ

Примеры Markdown

Образцы просмотрщика Markdown

Примеры Markdown Презентаций

PDF Примеры

Markdown в HTML Конвертер

Markdown в обычный текст

Карточка спеков Figma iOS Android pt dp sp (адаптивный дизайн)

Сравнение хеш-алгоритмов