Document tools

AsciiDoc to Markdown

Convert asciidoc to markdown with pandoc. Runs entirely on your device.

Runs on your device. The file is never uploaded.

AsciiDoc to Markdown reads an .adoc file and writes Markdown, source blocks becoming fenced code that keeps the language. This pandoc build carries an AsciiDoc reader, which older pandoc releases lacked entirely. Admonitions like NOTE and TIP have no Markdown counterpart, so they arrive as a fenced div or as bare text.

Input

Questions

Can pandoc read AsciiDoc?

In this build, yes. Pandoc shipped an AsciiDoc writer for years with no reader at all, so many guides still say the conversion is one-way. The pandoc WebAssembly build here has both, which is why this tool and Markdown to AsciiDoc both exist. Its reader is pandoc's own, so Asciidoctor-only extensions might not survive; check the output.

Why is my include directive not expanded?

Because only the file you drop is given to pandoc, and nothing here can open the file an include line names. Assemble the book into a single .adoc first if you want everything in one Markdown file, or convert each part separately and stitch the results together.

What happens to admonitions like NOTE and TIP?

Markdown has no admonition syntax, so they cannot survive as admonitions. Depending on how they are written they come through as a fenced div in pandoc's Markdown or as plain text with the label still visible. Look at those spots after converting and rewrite them for wherever the Markdown is going.

Do tables and code blocks come across?

Yes. AsciiDoc tables become Markdown tables and source blocks become fenced code blocks with the language kept where AsciiDoc named one. Pandoc's Markdown has a table syntax rich enough for most of what AsciiDoc can express, though complex cell spans might be simplified.

What is the file called, and how do I go back?

The output is your file name with the .md extension, shown on the page as well as offered as a download. Markdown to AsciiDoc converts the other way and names its output .adoc. Both run in this tab with nothing uploaded.

Related Document tools