This converter turns AsciiDoc (Asciidoctor, Antora) into GitHub Flavored Markdown: title and sections, source blocks, tables, admonitions, nested lists, footnotes and attribute references. Paste .adoc text and copy the Markdown.
Last updated:
How it works
Paste AsciiDoc
Paste an .adoc page, open a file or try the sample.
Choose the Markdown style
Admonitions as GitHub alerts or quotes, list marker, emphasis and code fence.
Copy the Markdown
Use it on GitHub, in MkDocs, Docusaurus or Obsidian; the preview shows the result.
Features
Attributes substituted
Attribute entries like :product: Event Store are applied to {product} references in the text.
Blocks
Listing, literal, quote, example, sidebar and passthrough blocks, block titles (.Title) and [source,lang] attributes.
Tables
|=== tables with cols alignment, header rows (option or blank line) and multi-line cells.
Lists
*, ** and . … nesting, checklists, list continuations (+), description lists (term::).
Limits & privacy
Files up to 10 MB. Inputs above 256 KB are converted in a Web Worker. Nothing is uploaded: the conversion runs in your browser, and Open from URL fetches the file directly from the address you enter. See the privacy page.
Limits
Conditionals (ifdef, ifeval) are not evaluated. Column spans in tables are written as separate cells. AsciiMath formulas are kept as written; Markdown renderers expect TeX.
FAQ
How do I convert .adoc to .md?
Paste the AsciiDoc or open the file, then copy the Markdown or download it as an .md file.
Is include:: supported?
No. Included files cannot be read from the browser; the directive is skipped with a warning.
What happens to the document header?
= Title becomes the H1, author and revision lines are dropped, attributes are applied.
How are admonitions converted?
NOTE:, TIP:, IMPORTANT:, WARNING: and CAUTION: paragraphs and blocks map directly to GitHub alerts.
Can I convert Markdown to AsciiDoc?
Yes, with Markdown → AsciiDoc, linked above the result.