Elysia Tools

Browse tools, examples, visual explainers, and topic guides from one clear workspace.

Top Categories

Hubs

Language
ZHDERUPTENFRES

Elysia Tools

Navigation

Format Conversion

Markdown ⇄ AsciiDoc Converter

· Last updated:2026-08-22

Bidirectional converter between GitHub-Flavored Markdown and AsciiDoc — headings, tables, code blocks, admonitions, links, task lists and more, with side-by-side output and conversion notes.

Details

What this tool helps you do

Line-based block parser with inline tokenizers, no external dependencies. Section levels shift by one (= is the AsciiDoc document title); link brackets invert (text ⇄ url[text]); code fences ⇄ [source,lang] + ----; GFM pipe tables ⇄ |=== with options="header" and alignment colspecs; NOTE/TIP/IMPORTANT/WARNING/CAUTION admonitions ⇄ GitHub alerts (> [!NOTE]; the legacy > Note form is recognized on input); task lists, footnotes, anchors and cross-references, hard line breaks and horizontal rules all round-trip. include::, {attributes} and conditional directives degrade to HTML comments with a visible note. Round-trip losslessness is not promised — the goal is a correct one-way migration.

Execution

Run this tool

Fill in the form, run the tool, and review the result in one place.

Samples

Examples that match this tool

Related

Continue with connected tools and hubs

Written by the Elysia Tools team

Tool usage guide

Learn when to use this tool, what it supports, and how real users apply it.

Key facts

Category
Format Conversion
Input types
select, textarea, checkbox
Output type
html
Sample coverage
4
API ready
Yes

Overview

The Markdown ⇄ AsciiDoc Converter transforms technical documentation bidirectionally between GitHub-Flavored Markdown and AsciiDoc syntax. It translates document headings, link formatting, source code fences, pipe tables, admonitions, and task lists while preserving structural hierarchy.

When to use

  • Migrating static documentation sets or README files from Markdown to AsciiDoc for Antora or Asciidoctor workflows.
  • Exporting AsciiDoc technical manuals into standard GitHub-Flavored Markdown for repository hosting or platform publishing.
  • Converting structured docs containing tables, code fences, alerts, and inline anchors without manually reformatting syntax.

How it works

  1. 1Select the conversion direction: Markdown → AsciiDoc (`md2ad`) or AsciiDoc → Markdown (`ad2md`).
  2. 2Paste your raw markup into the source document editor and configure options like H1 document title promotion and unresolved tag retention.
  3. 3The line-based block parser and inline tokenizer map matching structures like link targets, table colspecs, admonition blocks, and code tags into the target syntax.

Use cases

  • Publishing Markdown developer guides to Antora component documentation sites using native AsciiDoc files.
  • Translating legacy AsciiDoc API documentation into Markdown for GitHub wiki pages or static site generators.
  • Standardizing mixed open-source contributor pull requests containing varied Markdown and AsciiDoc markup.

Examples

1. Migrating a Markdown Release Note to AsciiDoc

Technical Writer

Background

A software team is migrating documentation from a standard Markdown wiki to an Asciidoctor-powered static documentation site.

Problem

Manual conversion of GFM tables, code blocks, task lists, and note callouts is time-consuming and error-prone.

How to use

Select Markdown → AsciiDoc (`md2ad`), paste the Markdown release notes, check 'Promote first H1 to document title', and run the conversion.

direction: md2ad, promoteTitle: true, keepUnresolved: true

Outcome

Generates a clean AsciiDoc file with `= Title`, `[source,python]` blocks, `|===` tables, and native `NOTE:` admonitions.

2. Exporting AsciiDoc Component Specs to GitHub Markdown

DevOps Engineer

Background

An internal project written in AsciiDoc needs to be shared as a repository `README.md` on GitHub.

Problem

AsciiDoc syntax such as `link:url[text]`, `[source]` blocks, and `|===` tables do not render correctly on standard Markdown readers.

How to use

FAQ

How are Markdown links converted to AsciiDoc?

Markdown link brackets invert to AsciiDoc syntax, turning `[text](url)` into `url[text]` while escaping URLs containing special characters.

What does the title promotion option do?

When enabled in Markdown to AsciiDoc conversion, the first `#` heading is promoted to a single `=` document title rather than a standard section title.

How are GitHub Alerts and AsciiDoc admonitions mapped?

Blocks like `> [!NOTE]` or `> **Note**` convert to AsciiDoc `NOTE:` admonitions, and vice versa.

What happens to AsciiDoc directives like include:: during export to Markdown?

Directives such as `include::`, attribute references, and conditional statements degrade into visible HTML comments so no context is silently lost.

Can I convert GitHub-Flavored Markdown tables with column alignments?

Yes, Markdown pipe tables convert to AsciiDoc `|===` blocks with `options="header"` and corresponding alignment specifiers in `cols`.

Home
Tools3212
Samples593
Visualizations471
Viewers103
Hubs239
Tags333
Images, Audio & Video657

Image, audio, and video processing, conversion, and optimization tools

Math, Date & Finance647

Calculators, numerics, date logic, statistics, and finance tools

Design & Color298

Color, layout, graphics, visual styling, and design helper tools

Text & Writing209

Writing, cleanup, formatting, extraction, and text analysis tools

Developer & Web193

Developer utilities, networking, web debugging, and automation helpers

Conversion & Encoding175

Format, file, archive, unit, and encoding conversion tools

Lead Generation Quiz Launch and Contact Handoff
Memorial Drafts: Family Review and Print Handoff
Private Habit Records: Backup, Restore and Sharing Review
Article to X and LinkedIn Drafts: Fact Review and Handoff
Markdown Interactive Deck Review and Offline Handoff

© 2026 Elysia Tools. All rights reserved.

DocsPricingAboutTerms of ServicePrivacy PolicyCookiesContact
Data Formats

Markdown Samples

Markdown format examples from simple to complex document structures

Document

Markdown Viewer Samples

Sample Markdown files for README preview, documentation rendering, and rich-text markup tests

Documentation

Markdown Slide Deck Samples

Remark/Marp style Markdown slide decks for testing PDF export layouts

Document

PDF Samples

Generated PDF samples from tools dated 2026-02-01 to 2026-02-10

Format Conversion

Markdown to HTML Converter

Convert Markdown text to HTML with customizable formatting options using Showdown

Format Conversion

Markdown to Plain Text

Convert Markdown formatted text to plain text by removing all Markdown syntax and formatting

Design

Figma iOS Android pt dp sp Responsive Design Spec Card

Convert a Figma px value into iOS pt, Android dp/sp, web rem/vw with a fluid clamp() snippet, a density-bucket render table and a touch-target accessibility audit, as a developer spec card.

Cryptography

Hash Algorithm Comparator

Hash the same input with MD5, SHA-1, SHA-256, SHA-512, BLAKE2b, and BLAKE3 at the same time and compare them side by side: output length, hex/Base64 digest, security status (broken / modern), and a relative speed benchmark. Great for teaching, choosing a hashing algorithm, or sanity-checking checksums.

Set direction to AsciiDoc → Markdown (`ad2md`), paste the AsciiDoc source, and convert.

direction: ad2md, promoteTitle: false, keepUnresolved: true

Outcome

Produces valid GitHub-Flavored Markdown with markdown pipe tables, code backticks, and `> [!NOTE]` alert blocks.