Skip to main content

Markdown to AsciiDoc Converter

Convert Markdown (CommonMark / GitHub-Flavored) to AsciiDoc — headings, bold/italic, fenced code blocks with language labels, tables, links, images, blockquotes, nested lists and task lists.

Input

Output

AsciiDoc source
 
Was this helpful?

Guides

Paste Markdown and get accurate AsciiDoc source — headings, bold and italic, fenced code blocks with their language label, tables, links, images, blockquotes, and nested or task lists all convert with the correct delimiter counts and attribute headers. It runs entirely in your browser.

How do I use it?

Type or paste your Markdown on the left. The AsciiDoc source appears on the right, ready to copy or download as a .adoc file. Toggle the options to match the flavour of Markdown you're converting from.

Why not just ask an AI to convert it?

Markdown → AsciiDoc is a mechanical syntax mapping, but the two languages structure blocks differently enough that a plausible-looking rewrite is often subtly wrong: a fenced code block needs a [source,lang] header line and a matching pair of ---- delimiters (not the Markdown triple-backtick), a blockquote needs ____ delimiters, and nested lists need one extra marker character (**, ***) per level rather than indentation. This converter parses your Markdown into a real syntax tree first and emits AsciiDoc from that structure, so delimiter counts and list nesting come out correct instead of eyeballed.

What does it convert?

Headings (# through ######), bold/italic/strikethrough, inline and fenced code (with the language preserved as an AsciiDoc [source,lang] block), ordered/unordered/task lists (including nesting), blockquotes, tables, links, images, horizontal rules, and hard line breaks.

What is GitHub-Flavored Markdown?

GitHub-Flavored Markdown (GFM) is the popular superset of standard Markdown used on GitHub, in many wikis, and across countless developer tools. On top of the basics it adds tables, strikethrough, and task lists (- [ ] / - [x]), which map onto AsciiDoc's own table and checklist syntax. Leave the GFM option on for the most familiar behaviour; turn it off for strict CommonMark.

Is my content private?

Yes. The conversion happens entirely in your browser; your Markdown is never uploaded or stored.

Related tools

markdownasciidocadocmdcommonmarkgfmdocumentationconverter

Use it from code

From 3 credits per call

REST API

curl -X POST https://api.iotools.cloud/v1/tool/markdown-to-asciidoc \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "# Hello World\n\nThis is **bold** and this is *ita…",
    "gfm": "true",
    "breaks": ""
  }'

Swap in your own key from your account. The tool's fields are the body — no wrapper.

Ask an AI agent

Use the IOTools `markdown-to-asciidoc` tool (Markdown to AsciiDoc Converter) on this input:

YOUR_INPUT_HERE

Paste this at any agent connected to the IOTools MCP server, then add your input.

Love the tools? Lose the ads.

One payment clears every ad from your account, for good. No subscription, no tracking.