Asciidoctor Asciidoctor Docs
AsciiDoc
Language Syntax Quick Reference
Processing
Asciidoctor Ruby Asciidoctor.js JavaScript AsciidoctorJ Java
Extensions
Add-on Converters
reveal.js Ruby, JavaScript
Extended Syntax
Asciidoctor Diagram Ruby
Tooling
Build Automation
Maven Tools Java Asciidoclet Java
Text Editors / Viewers
IntelliJ Plugin

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
    • Available Converters
    • Generate HTML
      • Stylesheets
        • Default Stylesheet
        • Stylesheet Modes
        • Apply a Custom Stylesheet
        • Embed a CodeRay or Pygments Stylesheet
      • Manage Images
      • Add a Favicon
      • Verbatim Block Line Wrapping
      • Skip Front Matter
    • Generate DocBook
    • Generate Manual Pages
    • Process AsciiDoc Using the CLI
      • 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 Strings
      • Generate an HTML TOC
      • Load Custom Templates
      • Set Safe Mode
      • API Options
    • Safe Modes
      • Safe Mode Specific Content
    • Docinfo Files
    • 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
      • 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
    • 2.2
  • AsciidoctorJ
    • 2.4
  • Maven Tools
    • 2.1
  • Asciidoclet
    • 1.5.6
  • Asciidoctor reveal.js
    • 4.1
  • Asciidoctor EPUB3
    • 1.5
  • Asciidoctor Diagram
    • 2.0
  • 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.

Migrate from DocBook XML Migrate from Confluence XHTML
Asciidoctor
Asciidoctor
  • Home
  • Docs
  • Source
  • Discuss

Copyright © 2021 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 based on the default Antora UI and is licensed under the MPL-2.0 license. Several icons are imported from Octicons and are licensed under the MIT license.

AsciiDoc is a Trademark of the Eclipse Foundation, Inc.

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

OpenDevise Logo Algolia logo Deploys by Netlify

Authored in AsciiDoc.
Produced by Antora and Asciidoctor.