Simple API
For Atlassian's Document Format

BLOG

24Oct
Standard Post with Image

ADF vs HTML: How Atlassian Structures Rich Text

If you’ve ever worked with Atlassian products like Jira or Confluence Cloud, you’ve likely come across the mysterious Atlassian Document Format (ADF) — a JSON-based schema that powers how rich text and structured content are stored and rendered.

At first glance, ADF looks nothing like HTML. Instead of <p>, <strong>, and <ul>, you’ll find nested objects like "type": "paragraph" or "marks": [{"type": "strong"}]. But ADF isn’t just another markup language — it’s a purpose-built, structured representation of content designed for modern collaborative editing.

Read More
17Oct
Standard Post with Image

Introducing AdfKit: The Ultimate NuGet Package for Atlassian Document Format Conversions

We’re excited to announce the launch of AdfKit, our comprehensive NuGet package that brings the full power of Atlassian Document Format (ADF) conversion directly to your .NET applications. While our API service has been serving thousands of developers worldwide, we recognized that many teams need the flexibility, performance, and security benefits that come with a local solution.

Why Choose AdfKit Over the API?

Enhanced Security & Privacy

With AdfKit, your sensitive documents never leave your infrastructure. Process confidential content, proprietary documentation, and sensitive data without worrying about external API calls or data transmission. Perfect for:

Read More
15Oct
Standard Post with Image

Converting RTF to Atlassian Document Format: New Endpoint Available

Introducing RTF to ADF Conversion: Expanding Document Format Support

We’re excited to announce a powerful new addition to the ADFAPI.dev platform: RTF (Rich Text Format) to ADF conversion. This latest endpoint expands our document conversion capabilities, making it easier than ever to migrate RTF documents into Atlassian’s ecosystem.

What is RTF and Why Convert to ADF?

Rich Text Format (RTF) is a widely-used document format that preserves text formatting across different applications and platforms. Developed by Microsoft, RTF files contain formatted text, images, and other document elements that can be opened by most word processors.

Read More
23Sep
Standard Post with Image

Introducing ADF Rendering on adfapi.dev

We’re excited to announce a new feature on adfapi.dev: you can now automatically render Atlassian Document Format (ADF) JSON into HTML, right in your browser.

For a while, adfapi.dev has been the go-to resource for developers working with the Atlassian Document Format — whether you’re building Jira or Confluence apps, integrating with the REST APIs, or just trying to understand how ADF works. Until now, the platform primarily focused on parsing, validating, and converting ADF through our API.

Read More
18Sep
Standard Post with Image

Convert HTML to Atlassian Document Format (ADF) with PowerShell and ADFAPI

Working with Jira or Confluence often means dealing with Atlassian Document Format (ADF) — the structured JSON schema behind rich text content.

Manually writing ADF is tedious and error-prone. That’s where ADFAPI comes in: a hosted API that converts HTML or Markdown into clean, valid ADF.

In this post, we’ll show you how to use PowerShell to convert HTML to ADF JSON, both from a file and directly from a raw HTML string — and how to preview the results visually in your browser.

Read More
18Sep
Standard Post with Image

HTML to Atlassian Document Format: The NPM Libraries You Can Use

If you’ve ever needed to get your HTML into Jira or Confluence, you know the process isn’t exactly straightforward. Atlassian uses its own JSON-based document model called Atlassian Document Format (ADF). While ADF is flexible and powerful, generating it from HTML can be a hassle.

Fortunately, there are a few NPM libraries that attempt to bridge the gap and convert HTML into ADF. In this post, we’ll walk through what’s out there today, and also show you an alternative if you’d rather not spend time running and maintaining these libraries yourself.

Read More
17Jul
Standard Post with Image

Word to ADF Conversion Now Live!

Word to ADF Conversion Is Now Live on adfapi.dev!

We’re excited to announce a major new milestone for adfapi.dev: you can now convert Word documents (.docx) to Atlassian Document Format (ADF) — directly in your browser, with no signup required.

Just head to the Try It page, upload a Word file, and see the ADF JSON instantly. It’s never been easier to bring your existing content into Confluence, Jira, or any other Atlassian product that uses ADF.

Read More
27Jun
Standard Post with Image

Important Update: API Key (Soft) Requirement Starting August

Since launching adfapi.dev, our mission has been simple: provide a fast, reliable way to convert documents into the Atlassian Document Format (ADF) — with zero setup and no friction. We’ve been thrilled by the response and the wide adoption of the API across tools, workflows, and platforms.

To keep the service sustainable and continue improving it, we’re making a small change that takes effect starting August 1st.

What’s Changing?

Starting in August, any API requests without an API key will result in converted documents that include a short line of text:

Read More
24Jun
Standard Post with Image

What Is Atlassian Document Format (ADF) and Why Should You Care?

If you’ve ever tried to programmatically create rich content in Confluence or Jira, you’ve likely come across a mysterious acronym: ADF — short for Atlassian Document Format. But what is ADF really, and why should it matter to your team, your documentation strategy, or your development workflow?

In this post, we’ll break down what ADF is, why it exists, and why understanding it can unlock powerful automation, migration, and integration capabilities across the Atlassian ecosystem.

Read More
19Dec
Standard Post with Image

CSV to Atlassian Document Format

CSV to Atlassian Document Format Conversions are Here!

As the world becomes increasingly digital, collaboration and communication have become essential components of any successful project. With numerous tools and platforms available, it’s crucial to ensure seamless integration between them. In this blog post, we’re excited to announce that CSV to Atlassian Document Format (ADF) conversions are now possible with ADF API.

The Power of Conversions

Converting files from one format to another can be a tedious task, especially when working across different platforms and tools. With the rise of collaboration-focused applications like Atlassian’s Jira, Trello, and Confluence, it’s essential to have a reliable way to convert documents between formats.

Read More
19Dec
Standard Post with Image

Open Document to Atlassian Document Format

Open Document to Atlassian Document Format Conversions are Here!

As the world becomes increasingly digital, collaboration and communication have become essential components of any successful project. With numerous tools and platforms available, it’s crucial to ensure seamless integration between them. In this blog post, we’re excited to announce that Open Document to Atlassian Document Format (ADF) conversions are now possible with ADF API.

The Power of Conversions

Converting files from one format to another can be a tedious task, especially when working across different platforms and tools. With the rise of collaboration-focused applications like Atlassian’s Jira, Trello, and Confluence, it’s essential to have a reliable way to convert documents between formats.

Read More
18Dec
Standard Post with Image

Microsoft Word to Atlassian Document Format

Microsoft Word to Atlassian Document Format Conversions are Here!

As the world becomes increasingly digital, collaboration and communication have become essential components of any successful project. With numerous tools and platforms available, it’s crucial to ensure seamless integration between them. In this blog post, we’re excited to announce that Microsoft Word to Atlassian Document Format (ADF) conversions are now possible with ADF API.

The Power of Conversions

Converting files from one format to another can be a tedious task, especially when working across different platforms and tools. With the rise of collaboration-focused applications like Atlassian’s Jira, Trello, and Confluence, it’s essential to have a reliable way to convert documents between formats.

Read More
27Aug
Standard Post with Image

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.

Read More
26Aug
Standard Post with Image

Converting HTML to Atlassian's Document Format

Converting HTML to Atlassian’s Document Format

In this blog post we will discuss how to convert HTML 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.

Read More
20Aug
Standard Post with Image

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:

Read More
6Jul
Standard Post with Image

What is adfapi.dev?

Seamless Document Conversion: Unlocking the Power of ADFAPIs

In the era of digital collaboration, documents are the backbone of communication, project management, and data sharing. However, the multitude of document formats can pose challenges in interoperability and accessibility. Enter ADFAPI, designed to effortlessly convert any document format to the Atlassian Document Format and vice versa. This powerful tool ensures seamless integration and collaboration, making document management a breeze.

Understanding the Atlassian Document Format

Before diving into the capabilities of ADFAPI, it’s essential to understand what the Atlassian document format is. Atlassian, known for its suite of collaboration tools like Confluence, Jira, and Trello, uses a specific document format that enables rich content creation, seamless integration with other Atlassian products, and enhanced collaboration features.

Read More
24Jun
Standard Post with Image

Introducing adfapi.dev!

Hello world! This is our first post!

Welcome to adfapi.dev If you’re looking for an easy way to convert documents to and from the Atlassian Document Format, then we can help you!

adfapi.dev was built to scratch an itch. Our team needed to migrate from Pivotal Tracker and Azure DevOps to JIRA. We looked for an API to do this, but couldn’t find one. We found some libraries, but the conversion was not complete and sometimes looked really weird. It also required a lot of manual work to fix the formatting issues.

Read More