How are Markdown links converted to AsciiDoc?

Markdown link brackets invert to AsciiDoc syntax, turning `[text](url)` into `url[text]` while escaping URLs containing special characters.

What does the title promotion option do?

When enabled in Markdown to AsciiDoc conversion, the first `#` heading is promoted to a single `=` document title rather than a standard section title.

How are GitHub Alerts and AsciiDoc admonitions mapped?

Blocks like `> [!NOTE]` or `> **Note**` convert to AsciiDoc `NOTE:` admonitions, and vice versa.

What happens to AsciiDoc directives like include:: during export to Markdown?

Directives such as `include::`, attribute references, and conditional statements degrade into visible HTML comments so no context is silently lost.

Can I convert GitHub-Flavored Markdown tables with column alignments?

Yes, Markdown pipe tables convert to AsciiDoc `|===` blocks with `options="header"` and corresponding alignment specifiers in `cols`.

Elysia Tools

Navigation

Format Conversion

Markdown ⇄ AsciiDoc Converter

Bidirectional converter between GitHub-Flavored Markdown and AsciiDoc — headings, tables, code blocks, admonitions, links, task lists and more, with side-by-side output and conversion notes.

Details

What this tool helps you do

Line-based block parser with inline tokenizers, no external dependencies. Section levels shift by one (= is the AsciiDoc document title); link brackets invert (text ⇄ url[text]); code fences ⇄ [source,lang] + ----; GFM pipe tables ⇄ |=== with options="header" and alignment colspecs; NOTE/TIP/IMPORTANT/WARNING/CAUTION admonitions ⇄ GitHub alerts (> [!NOTE]; the legacy > Note form is recognized on input); task lists, footnotes, anchors and cross-references, hard line breaks and horizontal rules all round-trip. include::, {attributes} and conditional directives degrade to HTML comments with a visible note. Round-trip losslessness is not promised — the goal is a correct one-way migration.

Execution

Run this tool

Fill in the form, run the tool, and review the result in one place.

Samples

Markdown ⇄ AsciiDoc Converter

What this tool helps you do

Run this tool

Examples that match this tool

Continue with connected tools and hubs

Learn when to use this tool, what it supports, and how real users apply it.

Key facts

Overview

When to use

How it works

Use cases

Examples

1. Migrating a Markdown Release Note to AsciiDoc

2. Exporting AsciiDoc Component Specs to GitHub Markdown

FAQ

Markdown Samples

Markdown Viewer Samples

Markdown Slide Deck Samples

PDF Samples

Markdown to HTML Converter

Markdown to Plain Text

Figma iOS Android pt dp sp Responsive Design Spec Card

Hash Algorithm Comparator