Перейти до вмісту

Конвертер 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, написані з однією коміркою на рядок і пустими рядками-розділювачами, не реконструюються.
Мій документ завантажується кудись?
Ні. Конверсія виконується повністю у вашому браузері — нічого, що ви вставляєте, ніколи не залишає ваш пристрій.