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
Related Tools
Convert LaTeX to Markdown
Convert LaTeX documents to Markdown — sections, lists, and math expressions handled. For full fidelity, we recommend Pandoc; for quick conversion, paste your LaTeX here.
Convert MediaWiki to Markdown
Convert MediaWiki markup to clean Markdown. Handles `==H==` headings, `* lists`, `[[links]]`, `'''bold'''`, and `<ref>` footnotes. Ideal for wiki-to-static-site migrations.
Convert Markdown to HTML
Render Markdown into clean semantic HTML — ready for blogs, emails, or static sites. Handles GFM tables, code fences with language hints, and frontmatter strip.
Process bigger files in @vustMarkdownBot
500-character free conversions in chat — pay-as-you-go for longer text.