Parent Group

Atlassian Confluence

Customer-operated CLI tools for page-level and space-level Confluence export, migration, continuity, governance, and AI-ready Markdown workflows.

Related tool in this group: acp2md

Space-Scale Export

acs2md

Atlassian Confluence Space to Markdown for whole-space export and synchronization.

acs2md, short for Atlassian Confluence Space to Markdown, is built for large-scale documentation operations: continuity copies, disaster recovery archives, Git migrations, repeatable AI-ready corpora, and shared space plus page workflows from one binary.

$ acs2md space convert by-key DOCS --output-dir ./docs-export
→ Listing pages in DOCS...
→ Syncing changed pages only...
→ Rewriting internal links...
✓ Exported ./docs-export
$_
Powerful Capabilities

Key Features

acs2md is built for space-scale export, synchronization, governance, and repeatable downstream use.

Full-Space Conversion

Export an entire Confluence space in one run, preserving hierarchy as folders and files.

Hierarchy and Link Rewriting

Preserve the page tree as folders and files while rewriting internal Confluence links to local relative paths.

Efficient Sync State

Use local .convert-sync-state.json tracking to skip unchanged pages and keep recurring exports practical.

Space Inventory and Permissions

List spaces, pages, properties, and permissions for governance, audit preparation, and migration planning.

Shared Page Commands

Run page convert, get, count, and properties commands from the same binary when you need targeted work inside a broader export workflow.

Progress and Automation Ready

Use stderr progress bars and structured output in long-running jobs without breaking automation or pipelines.

Simple & Reliable

How It Works

1

Authenticate

Provide your Atlassian API token securely via environment variables.

2

Fetch Content

acs2md queries the Confluence Cloud API and retrieves page content in ADF format.

3

Transform

The tool converts complex ADF JSON structures to clean, standard CommonMark Markdown.

4

Export

Save your Markdown files locally, commit to Git, or integrate into your workflow.

Format Conversion Overview

CConfluence

  • Browser-based
  • ADF format (JSON)
  • Auth-walled access
  • Difficult to version

acs2md

MMarkdown

  • Plain text
  • CommonMark/GFM
  • Git-friendly
  • Universal standard
Real-World Applications

Ideal Use Cases

Continuity Copies

Maintain a current Markdown copy of a full documentation space outside Confluence for operational resilience.

Disaster Recovery Archives

Build recoverable, customer-controlled archives that do not depend on the source platform to read or store your documentation.

Documentation Migration

Move a full Confluence estate into Git-based documentation workflows while preserving structure and navigability.

AI Corpus Generation

Create repeatable Markdown corpora for enterprise search, retrieval, and knowledge assistant pipelines.

Governance and Access Review

Inspect space metadata, page inventory, and permissions before audits, cleanups, or platform transitions.

Recurring Export Automation

Run scheduled changed-only exports in CI or internal automation, while still using built-in page commands for targeted follow-up work.

Quick Setup

Getting Started

1. Prerequisites

  • A valid acs2md license
  • Read access to the target Confluence space
  • An Atlassian API token and a destination directory for exported documentation

2. Generate an API Token

acs2md uses Atlassian API tokens for secure authentication:

  1. Visit Atlassian Account
  2. Click Create API Token
  3. Label it acs2md-cli
  4. Copy the token immediately (you won't see it again)

Security Tip: Never hardcode your token. Use environment variables or a secrets manager.

3. Set Environment Variables

Configure acs2md with tool-specific Confluence environment variables:

export ACS2MD_CONFLUENCE_DOMAIN="your-domain.atlassian.net"
export ACS2MD_CONFLUENCE_USERNAME="email@example.com"
export ACS2MD_CONFLUENCE_API_TOKEN="your-api-token"

4. Your First Conversion

Convert a full Confluence space to Markdown:

$ acs2md space convert by-key DOCS --output-dir ./docs-export

Replace DOCS with your real Confluence space key. Use acs2md space list if you need to discover available spaces.

5. Common Commands

Convert an entire space:

acs2md space convert by-key <SPACE_KEY> --output-dir ./docs

List available spaces:

acs2md space list

Inspect one page from the same binary:

acs2md page get by-id <PAGE_ID> -f atlas_doc_format > ./page.json

Need Help?

Use the detailed docs when you need sync strategy, page commands, link rewriting, permissions, or space inventory guidance.

Read the Documentation