Перейти к содержанию

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

Преобразуйте синтаксис AsciiDoc в Markdown и обратно прямо в браузере.

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

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

Вставьте AsciiDoc — файл README, страницу документации, отрывок из вики — и этот инструмент переписывает его как Markdown. Заголовки (=, ==, вплоть до ======) становятся # по ######. Жирный текст (*слово*) становится **слово**, в то время как курсив (_слово_) и встроенный код (`слово`) уже имеют один и тот же синтаксис в обоих форматах и проходят без изменений. link:url[текст] и простой https://url[текст] становятся [текст](url), image::url[альт] становится ![альт](url), блок [source,язык], обёрнутый в ----, становится огороженным блоком кода, а таблица |=== становится таблицей Markdown с разделительной строкой заголовка. Примечания NOTE, TIP, WARNING, IMPORTANT и CAUTION становятся блокировками цитат или оповещениями в стиле GitHub, и всё это работает в обратном направлении тоже, из Markdown обратно в AsciiDoc, через опцию направления.

Другие опции формируют детали: стиль заголовков выбирает ATX (#) или Setext (подчёркивание = или -, только первые два уровня — более глубокие заголовки возвращаются к ATX); формат примечаний выбирает простую блокировку цитаты или блок оповещения GitHub; стиль маркеров выбирает тире или звёздочку для неупорядоченных списков; а сохранение атрибутов как фронтмэтра преобразует строки :name: значение AsciiDoc в блок YAML вместо их удаления, отражаясь в обратном направлении тоже.

Это лёгкий, основанный на шаблонах конвертер, а не полный синтаксический анализатор, поэтому он работает лучше всего с приведёнными выше конструкциями. Упорядоченные списки всегда отображаются как «1.» или «.» — средства визуализации нумеруют последовательно независимо от цифр самого маркера, поэтому нумерация не влияет. Окончания строк Windows и Unix обрабатываются одинаково, а счёт сообщает строки входа, выхода и преобразованные элементы.

Всё выполняется локально в вашем браузере по мере ввода — ничего, что вы вставляете, не загружается, не регистрируется и не отправляется никуда. Скопируйте результат, загрузите его как файл .txt или отправьте обратно во вход для ещё одного прохода.

FAQ

Поддерживает ли этот инструмент оба направления — AsciiDoc в Markdown и Markdown в AsciiDoc?
Да. Опция направления переключает, какой формат читается и какой производится, а переключение также перемещает текущий выход обратно во входе, поэтому вы можете конвертировать одним способом и затем проверить обратное преобразование.
Почему упорядоченные списки всегда отображаются как «1.» или «.»?
И средства визуализации Markdown, и AsciiDoc нумеруют упорядоченные списки последовательно независимо от того, какая цифра или количество точек находится на каждой исходной строке, поэтому написание каждого маркера одинаково по-прежнему производит правильно пронумерованный выход без необходимости конвертеру отслеживать счётчики.
Что происходит с конструкциями AsciiDoc, которые этот инструмент не распознаёт?
Всё, что находится за пределами поддерживаемого набора — заголовки, жирный текст, ссылки, изображения, блоки перечисления, таблицы с одной строкой на линию, примечания, списки и :name: атрибуты значений — остаётся простым текстом, а не предположением, поэтому выход остаётся предсказуемым вместо того, чтобы молча искажать неизвестную разметку.
Может ли он конвертировать вложенные или многостроковые таблицы?
Он поддерживает обычную компактную форму, где каждая строка таблицы находится на своей собственной строке между разделителями |=== (AsciiDoc) или как стандартная таблица труб с разделительной строкой заголовка (Markdown). Таблицы AsciiDoc, написанные с одной ячейкой на строку и пустыми линиями-разделителями, не реконструируются.
Мой документ загружается куда-нибудь?
Нет. Конверсия выполняется полностью в вашем браузере — ничто, что вы вставляете, никогда не покидает ваше устройство.