Markdown · AsciiDoc to MD
Convert AsciiDoc to Markdown
Convert AsciiDoc documents to Markdown — headers, lists, and code fences handled. For full fidelity, Pandoc is recommended; for quick migration, paste your AsciiDoc here.
Free, no signup. Up to 1 MB per request.
This tool handles
- = H1 through ==== H4 headers
- Bulleted and numbered lists
- Admonitions (NOTE/TIP/WARNING/CAUTION)
- link:url[text] references
Not in scope
- include:: macros (inline source first)
- {attribute} substitution
- |=== table syntax
Try it live with the widget above — paste and see the output instantly. For the items under “Not in scope,” the migration guide below covers workarounds and when to use a different tool.
AsciiDoc to Markdown examples
Paste real AsciiDoc in the left column, see the Markdown output on the right.
How AsciiDoc-to-Markdown conversion works
Paste AsciiDoc — Paste your AsciiDoc source into the input field.
Convert — Click Convert — headers, lists, admonitions, and links are mapped to Markdown.
Copy — Copy the Markdown or download as `.md`.
AsciiDoc edge cases we handle
Admonitions map to GFM
NOTE / TIP / WARNING / CAUTION / IMPORTANT labels become `> [!TYPE]` GFM admonitions. Rendering depends on the target supporting them (GitHub, Obsidian with Callouts).
Code fence languages drop
`[source,lang]` attributes above `----` fences are dropped. Re-add language hints on triple-backtick fences if syntax highlighting matters.
Cross-references flatten
`<<ref>>` cross-references pass through as literal text. Markdown uses URL-fragment anchors; convert manually where references matter.
Includes must be inlined first
`include::file.adoc[]` directives are not resolved. Use Asciidoctor-reducer on the source before pasting, or inline the included files manually.
Frequently asked questions
What AsciiDoc elements are supported?
Headings (= H1, == H2), lists, code blocks, bold, italic, links, and tables are all converted.
What about AsciiDoc admonitions?
NOTE, TIP, WARNING, and CAUTION blocks are converted to GFM blockquote admonition syntax.
How does it compare to Pandoc?
Pandoc handles full AsciiDoc with higher fidelity. Our tool is faster for common documentation patterns.
Are cross-references preserved?
<<ref>> cross-references are preserved as placeholder links. You may need to update targets.
Related Tools
Process bigger files in @vustMarkdownBot
500-character free conversions in chat — pay-as-you-go for longer text.