AsciiDoc ↔ Markdown

Convert AsciiDoc to Markdown — and back — in your browser

Translate headings, source blocks, inline formatting, links, images, blockquotes, and lists between AsciiDoc and Markdown. Useful for book authors, docs migrations, and anyone bridging Markdown and Asciidoctor workflows.

Open the editor rST ↔ Markdown Markdown → Confluence

Converting Markdown → AsciiDoc

Markdown input

AsciiDoc output

= Migration guide

Welcome to our *migration guide*. We cover _what changed_ and how to adapt.

== Code sample

[source,python]
'''
def hello():
    print("hello")
'''

== Resources

* https://example.com/docs[Docs]
* https://example.com/changelog[Changelog]

____
Don't forget to test in staging first.
____

!/diagram.png[Diagram]

Covers headings, inline formatting, source blocks, links, images, blockquotes, lists, and HR. Complex AsciiDoc features (tables, attributes, includes, cross-references) require Pandoc.

When you need this converter

Technical book authoring. Many publishers (O'Reilly, Manning) prefer AsciiDoc. Engineers usually draft in Markdown for the live preview, then convert at submission time.
Open-source migration. Projects sometimes switch between formats — for example, Hibernate moved its docs from AsciiDoc to Markdown for friction-free contributions.
Doc imports. Pulling content from an Asciidoctor-powered site into an MDX-based docs framework.

What gets converted

Markdown	AsciiDoc
`# Heading`	`= Heading` (underline level)
`bold`	`bold`
`_italic_`	`_italic_`
`\`code``	`\`code``
```lang	`[source,lang] ---- … ----`
`[text](url)`	`url[text]`
`![alt](url)`	`image::url[alt]`
`> quote`	`____ … ____`
`- bullet`	`* bullet`
`---` (HR)	`'''`

Reverse direction maps the equivalent AsciiDoc constructs back to Markdown.

Companion tools

Markdown to Confluence — Atlassian destinations.
rST ↔ Markdown — Python ecosystem.
Markdown Editor — draft with live preview.

Privacy & data

The converter runs inside your browser. No content is uploaded.

Frequently asked questions

What is AsciiDoc?

AsciiDoc is a structured plain-text writing format popularized by the Asciidoctor project. It is widely used in technical book publishing (O'Reilly, Manning), engineering documentation, and some open-source projects. It supports richer semantics than Markdown — admonitions, sidebars, attribute substitution — at the cost of higher complexity.

Which AsciiDoc features convert?

Headings (`= H1` to `===== H5`), source blocks (`[source,lang] ---- ... ----`), bold, italic, inline code, hyperlinks, image directives, blockquotes (`____`), unordered and ordered lists, and horizontal rules. Tables and complex AsciiDoc-only features (attributes, includes) are simplified or left as-is.

Is this a one-shot or round-trip?

Use 'Switch direction' to convert in either direction. The transforms cover the most common cases for round-tripping prose; deep AsciiDoc features (cross-references, conditionals) won't survive both passes.

What about complex AsciiDoc tables?

AsciiDoc tables use `|===` delimiters and cell-attribute syntax that doesn't map directly to GFM pipe tables. For complex tables, convert by hand or use [Pandoc](https://pandoc.org/) which has the deepest AsciiDoc support.

How does this compare to Pandoc?

Pandoc is the gold standard for cross-format conversion — install it locally for batch jobs and edge cases. This online tool is for quick one-offs without setup, and for users who don't want to install local tooling for a single file.

Is my content uploaded?

No. Conversion runs in your browser tab.

Related tools

More free browser tools in the same workflow.

Use the API

Ship Markdown features in your product with our REST API — render, convert, audit, and transform documents at scale.

New to the platform? Start with the API quickstart, then try a live request in the API playground.

Explore the API platform