---
id: atlassian-doc-builder
version: "0.6.0"
license: MIT License Copyright (c) 2023 Kin Hin Wong Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# atlassian-doc-builder — Creating Atlassian Document in a programmatic way.

License: permissive · Maintenance: active · Downloads: 145.2K/mo

## What it is and what it does

Atlassian Document Builder lets you create Atlassian Document Format (ADF) documents programmatically instead of through the UI. It provides a tree-like object model that maps to ADF's JSON structure, so you can build documents in Python code, validate them against the schema, and render them as JSON ready for Confluence or Jira APIs. The package includes support for common elements like text, paragraphs, tables, links, lists, and collapsible sections, with a template system for reusable document patterns.

Typical use is automating report generation and publication into Confluence or Jira as part of CI/CD pipelines—for example, publishing functional verification reports or requirement documents directly from test runs or build systems. The package depends only on jsonschema for validation, making it lightweight to integrate into existing workflows.

Use it for:

- Automate generation of test reports and publish them to Confluence from CI/CD pipelines
- Programmatically create requirement or specification documents in Jira from source data
- Build reusable document templates with variable substitution for recurring report formats
- Generate tables and structured data exports from Python scripts into Atlassian documents
- Validate ADF document structure before sending to Confluence or Jira APIs

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Programmatically generate and validate Atlassian Document Format (ADF) documents for Confluence and Jira, with tree-like representation, JSON rendering, templating, and variable substitution.

Yes, if you need to automate Atlassian document creation from Python. The package is actively maintained, has low install friction, carries a permissive MIT license, and solves a specific problem with minimal dependencies. It is in Beta, so expect some API surface to evolve, but the core functionality is stable enough for production use in CI/CD automation.

## Install

pip install atlassian-doc-builder
uv add atlassian-doc-builder
poetry add atlassian-doc-builder

## Installing atlassian-doc-builder

Before you install: Low friction install with a single runtime dependency (jsonschema). Repository is active with recent commits and no archived status, though the project is in Beta development stage.

License in practice: MIT License permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install atlassian-doc-builder

from atlassian_doc_builder import ADFDocument, ADFParagraph, ADFText

doc = ADFDocument()
para = ADFParagraph()
para.append(ADFText('Hello, Confluence'))
doc.append(para)
json_output = doc.render()

Requires Python 3.8 or later.

Verify before relying:

- Whether the package supports all ADF node types or only a subset of the Atlassian specification
- Performance characteristics when generating large or deeply nested documents
- Compatibility with specific Confluence and Jira server/cloud versions

## Package facts

- License: MIT License Copyright (c) 2023 Kin Hin Wong Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 145.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

atlassian document format adf generation, confluence jira document automation, programmatic adf builder, atlassian report generation, adf document validation, confluence document api, jira document builder, atlassian-integration, document-generation, ci-cd-automation

[View on SkillFed](https://skillfed.io/packages/atlassian-doc-builder) · [View on PyPI](https://pypi.org/project/atlassian-doc-builder/)