A lightweight JavaScript library that transforms Markdown to the Atlassian Document Format (ADF). Built for easy integration with Atlassian products and APIs.
Visit our interactive playground to experiment with Markdown to ADF conversion in real-time.
- Convert Markdown to ADF with a single function call
- Support for the most common Markdown syntax
- TypeScript-ready with full type definitions
- Works in all modern JavaScript environments (Browsers, Node.js, Deno, Bun)
- Lightweight (12kb gzipped and minified), doesn't depend on AtlasKit dependencies
npm install marklassianimport { markdownToAdf } from 'marklassian';
const markdown = '# Hello World';
const adf = markdownToAdf(markdown);- Headings (H1-H6)
- Paragraphs and line breaks
- Emphasis (bold, italic, strikethrough)
- Links and images
- Code blocks with language support
- Ordered and unordered lists with nesting
- Blockquotes
- Horizontal rules
- Tables
Converts a Markdown string to an ADF document object (JSON serialisable).
type AdfNode = {
type: string;
attrs?: Record<string, any>;
content?: AdfNode[];
marks?: AdfMark[];
text?: string;
};
type AdfMark = {
type: string;
attrs?: Record<string, any>;
};
type AdfDocument = {
version: 1;
type: 'doc';
content: AdfNode[];
};Marklassian aims to provide a lightweight, fast and mostly accurate conversion from Markdown to ADF.
If you have complex Markdown or require strict conformance to the ADF format, you may need want to use the official Atlassian libraries. These are hefty dependencies that may bloat your project and require manual tree shaking.
The following example demonstrates how to use the official Atlassian libraries for Markdown to ADF conversion:
import { defaultSchema } from '@atlaskit/adf-schema';
import { JSONTransformer } from '@atlaskit/editor-json-transformer';
import { MarkdownTransformer } from '@atlaskit/editor-markdown-transformer';
const jsonTransformer = new JSONTransformer();
const markdownTransformer = new MarkdownTransformer(defaultSchema);
const markdownDocument = '';
const adfDocument = jsonTransformer.encode(markdownTransformer.parse(markdownDocument));Sourced from https://jira.atlassian.com/browse/JRACLOUD-77436
For those interested in the ADF format, the following resources may be helpful:
- Atlassian Document Format (ADF) Reference
- Atlassian Document Format Interactive Builder
- @atlaskit/adf-utils, an official Atlassian library for working with ADF documents. Provides validation and a Java-like builder API for creating ADF documents.
MIT