= Migrate from Markdown to Asciidoctor
:navtitle: Migrate from Markdown

Asciidoctor recognizes some Markdown syntax, thus allowing you to migrate from Markdown to AsciiDoc gradually.
See xref:asciidoc::syntax-quick-reference.adoc#markdown-compatibility[Markdown compatibility] to learn what syntax is shared.
The syntax you must change is listed in the table under the xref:asciidoc::asciidoc-vs-markdown.adoc#comparison-by-example[Comparison by example section].

You can use https://github.com/asciidoctor/kramdown-asciidoc[Kramdown AsciiDoc^] to automate the migration from Markdown to AsciiDoc.
