Markdown

Converting Markdown to Atlassian Document Format (ADF): Complete Guide

Migrating or integrating content between platforms like Jira and Confluence often means converting Markdown into Atlassian Document Format (ADF). Markdown remains the language of choice for developers, technical writers, and project managers due to its simplicity and readability. Jira and Confluence, however, rely on ADF—a JSON-based format designed for rich document representation. In this comprehensive guide, you’ll learn how to convert Markdown to ADF efficiently, compare manual vs. automated approaches, and leverage powerful APIs like adfapi.dev for seamless workflows in your Atlassian ecosystem.

Converting Markdown to Atlassian's Document Format

Converting Markdown to Atlassian’s Document Format

In this blog post we will discuss how to convert markdown text to Atlassian’s Document Format (ADF) using the adfapi.dev API.

Introduction

Atlassian’s Document Format (ADF) is a JSON-based format that is used by Atlassian products like Confluence and Jira to represent rich text documents. The format is designed to be easy to read and write, and is used to store and render documents in these products.

Try adfapi.dev for free

As part of our launch, we’d like to offere everyone the opportunity to try out adfapi.dev for free.

Try it on Your Browser

You can now try out the API yourself by going to our Try It page. Enter your html in the text box, press submit, and you’ll be able to see your document converted to the Atlassian Document Format for free.

Try the API directly

If you are a developer, you can try our API directly. Here is an example using curl: