Asciidoctor Asciidoctor Docs
AsciiDoc
Language Syntax Quick Reference
Processing
Asciidoctor Ruby Asciidoctor.js JavaScript AsciidoctorJ Java
Extensions
Add-on Converters
PDF Ruby EPUB3 Ruby reveal.js Ruby, JavaScript
Source Compilers
Reducer Ruby, JavaScript
Extended Syntax
Asciidoctor Diagram Ruby
Tooling
Build Automation
Maven Tools Java Gradle Plugin Java Asciidoclet Java
Text Editors / Viewers
Browser Extension IntelliJ Plugin
Chat Source Tweets

Asciidoctor

    • Features
    • What’s New in 2.0
    • Install and Update
      • Supported Platforms
      • Install Using Ruby Packaging
      • Install Using Linux Packaging
      • Install on macOS
      • Install on Windows
    • Convert Your First File
    • Converters
      • Available Converters
      • Custom Converter
      • Converter Templates
      • Convertible Contexts
    • Generate HTML
      • Stylesheets
        • Default Stylesheet
        • Stylesheet Modes
        • Apply a Custom Stylesheet
        • Embed a CodeRay or Pygments Stylesheet
      • Manage Images
      • Use Local Font Awesome
      • Add a Favicon
      • Verbatim Block Line Wrapping
      • Skip Front Matter
    • Generate DocBook
    • Generate Manual Pages
    • Process AsciiDoc Using the CLI
      • asciidoctor(1)
      • Specify an Output File
      • Process Multiple Source Files
      • Pipe Content Through the CLI
      • Set Safe Mode
      • CLI Options
    • Process AsciiDoc Using the API
      • Load and Convert Files
      • Load and Convert Strings
      • Generate an HTML TOC
      • Set Safe Mode
      • Enable the Sourcemap
      • Catalog Assets
      • Find Blocks
      • API Options
    • Safe Modes
      • Safe Mode Specific Content
    • AsciiDoc Tooling
    • Syntax Highlighting
      • Highlight.js
      • Rouge
      • CodeRay
      • Pygments
      • Custom Adapter
    • STEM Processing
      • MathJax and HTML
      • Asciidoctor Mathematical
      • STEM Support in the DocBook Toolchain
      • AsciiMath Gem
    • Extensions
      • Register Extensions
      • Log from an Extension
      • Preprocessor
      • Tree Processor
      • Postprocessor
      • Docinfo Processor
      • Block Processor
      • Compound Block Processor
      • Block Macro Processor
      • Inline Macro Processor
      • Include Processor
    • Localization Support
    • Errors and Warnings
    • Migration Guides
      • Upgrade from Asciidoctor 1.5.x to 2.0
      • Migrate from AsciiDoc.py
      • Migrate from DocBook XML
      • Migrate from Markdown
      • Migrate from Confluence XHTML
      • Migrate from MS Word
Asciidoctor 2.0
  • AsciiDoc
  • Asciidoctor
    • 2.0
  • Asciidoctor.js
    • 3.0
    • 2.2
  • AsciidoctorJ
    • 3.0
    • 2.5
  • Asciidoctor PDF
    • 2.3
    • 2.2
    • 2.1
    • 2.0
  • Asciidoctor EPUB3
    • 2.1
  • Asciidoctor reveal.js
    • 5.0
    • 4.1
  • Maven Tools
    • 3.2
  • Gradle Plugin Suite
    • 4.0
  • Asciidoclet
    • 2.0
    • 1.5.6
  • Asciidoctor Diagram
    • 2.3
  • Browser Extension
  • Community
  • Asciidoctor
  • Migration Guides
  • Migrate from Markdown
Edit this Page

Migrate from Markdown to Asciidoctor

Asciidoctor recognizes some Markdown syntax, thus allowing you to migrate from Markdown to AsciiDoc gradually. See Markdown compatibility to learn what syntax is shared. The syntax you must change is listed in the table under the Comparison by example section.

You can use Kramdown AsciiDoc to automate the migration from Markdown to AsciiDoc.

Migrate from DocBook XML Migrate from Confluence XHTML
Asciidoctor
Asciidoctor
  • Docs
  • Chat
  • Source
  • List (archive)

Twitter logo@asciidoctor

Copyright © 2025 Dan Allen, Sarah White, and individual Asciidoctor contributors. Except where noted, the content is licensed under a Creative Commons Attribution 4.0 International (CC BY 4.0) license.

The UI for this site is derived from the Antora default UI and is licensed under the MPL-2.0 license. Several icons are imported from Octicons and are licensed under the MIT license.

AsciiDoc® and AsciiDoc Language™ are trademarks of the Eclipse Foundation, Inc.

Thanks to our backers and contributors for helping to make this project possible. Additional thanks to:

OpenDevise Logo Zulip logo Algolia logo Deploys by Netlify

Authored in AsciiDoc.
Produced by Antora and Asciidoctor.