Parent Group
Atlassian Confluence
Customer-operated Confluence to Markdown CLI tools for page-level export, whole-space export, migration, continuity, governance, docs-as-code, and AI-ready Markdown workflows.
acs2md
Confluence Space to Markdown for full-space export, synchronization, backup, migration, and AI-ready knowledge preparation.
acs2md, short for Atlassian Confluence Space to Markdown, is built for large-scale documentation operations: continuity copies, disaster recovery archives, Git migrations, docs-as-code adoption, repeatable AI-ready corpora, and shared space plus page workflows from one binary.
Starting at €99.99 · Billed yearly through Lemon Squeezy
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.
How It Works
Authenticate
Provide your Atlassian API token securely via environment variables.
Fetch Content
acs2md queries the Confluence Cloud API and retrieves page content in ADF format.
Transform
The tool converts complex ADF JSON structures to clean, standard CommonMark Markdown.
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
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.
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:
- Visit Atlassian Account
- Click Create API Token
- Label it acs2md-cli
- 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:
4. Your First Conversion
Convert a full Confluence space to Markdown:
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:
List available spaces:
Inspect one page from the same binary:
Need Help?
Use the detailed docs when you need sync strategy, page commands, link rewriting, permissions, or space inventory guidance.
View Documentation