Blog

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.

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.