Elysia Tools

Просматривайте инструменты, примеры, визуальные объяснения и тематические руководства в одном понятном пространстве.

Популярные категории

Темы

Язык
ZHDERUPTENFRES

Elysia Tools

Навигация

Format Conversion

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

· Последнее обновление:2026-08-22

Двусторонняя конвертация между 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 без потерь не обещается — цель корректность однократной миграции.

Запуск

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

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

Примеры

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

Связано

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

Подготовлено командой Elysia Tools

Руководство по использованию инструмента

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

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

Категория
Format Conversion
Типы ввода
select, textarea, checkbox
Тип вывода
html
Покрытие примерами
4
API доступен
Да

Обзор

Онлайн-конвертер для двустороннего преобразования документации между Markdown (GitHub-Flavored Markdown) и AsciiDoc (стандарт Asciidoctor и Antora). Инструмент автоматически адаптирует уровни заголовков, синтаксис ссылок, таблицы, fenced-блоки кода, сноски, списки задач и блоки предупреждений.

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

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

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

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

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

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

Примеры

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

Технический писатель

Контекст

Команда разработчиков переносит проектную документацию из репозиториев GitHub в централизованную базу знаний на Antora.

Проблема

Исходный README содержит заголовки, списки задач, ссылки и таблицы GFM, требующие адаптации под синтаксис AsciiDoc.

Как использовать

Установите направление 'Markdown → AsciiDoc', включите повышение первого H1 и вставьте разметку README в поле ввода.

direction: md2ad, promoteTitle: true, keepUnresolved: true

Результат

Сгенерирован валидный документ AsciiDoc с титулом `=`, блоками `[source]`, таблицами `|===` и списками чек-боксов.

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

Разработчик

Контекст

Разработчик подготовил страницу руководства в формате AsciiDoc с блоками примечаний и исходным кодом, которую необходимо разместить в GitHub Wiki.

Проблема

Платформа Wiki использует Markdown, поэтому макросы ссылок, блоки `[source]` и директивы `NOTE:` нужно перевести в синтаксис GFM.

Как использовать

FAQ

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

Главная
Инструменты3212
Примеры593
Визуализации471
Средства просмотра файлов103
Темы239
Теги333
Изображения, аудио и видео657

Инструменты для обработки, конвертации и оптимизации изображений, аудио и видео

Математика, даты и финансы647

Калькуляторы, числовые инструменты, логика дат, статистика и финансы

Дизайн и цвет298

Инструменты для цвета, макетов, графики, визуального стиля и дизайна

Текст и письмо209

Инструменты для письма, очистки, форматирования, извлечения и анализа текста

Разработка и Web193

Инструменты разработчика, сетевые утилиты, веб-отладка и автоматизация

Преобразование и кодирование175

Инструменты для преобразования форматов, файлов, архивов, единиц и кодировок

Запуск квиза для привлечения потенциальных клиентов и передача контактов
Памятные тексты: семейная проверка и передача в печать
Личные привычки: резервная копия, восстановление и проверка перед передачей
Из статьи в черновики X и LinkedIn: проверка фактов и передача
Проверка интерактивного Markdown-урока и автономная передача

© 2026 Elysia Tools. Все права защищены.

ДокументацияТарифыО насУсловия использованияПолитика конфиденциальностиCookieКонтакты
Форматы данных

Примеры Markdown

Примеры формата Markdown от простых до сложных структур документов

Документы

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

Markdown-образцы для предпросмотра README, рендеринга документации и тестов разметки

Документация

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

Markdown колоды в стиле Remark/Marp для тестирования экспорта в PDF

Документы

PDF Примеры

PDF примеры, созданные инструментами 2026-02-01..2026-02-10

Format Conversion

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

Конвертирует текст Markdown в HTML с настраиваемыми опциями форматирования

Format Conversion

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

Преобразовать текст в формате Markdown в обычный текст, удалив весь синтаксис и форматирование Markdown

Design

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

Переводит 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.

Cryptography

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

Хеширует один и тот же вход с помощью MD5, SHA-1, SHA-256, SHA-512, BLAKE2b и BLAKE3 и сравнивает их: длину, hex/Base64-дайджест, статус безопасности (взломан/современный) и относительный бенчмарк скорости. Полезно для обучения, выбора алгоритма и проверки контрольных сумм.

Выберите направление 'AsciiDoc → Markdown', вставьте исходный текст руководства и скопируйте сконвертированный результат.

direction: ad2md, promoteTitle: false, keepUnresolved: true

Результат

Получен документ Markdown с алертами `> [!NOTE]`, стандартными ссылками `[текст](url)` и fenced-блоками кода.