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 on Confluence Cloud: continuity copies, disaster recovery archives, Git migrations, docs-as-code adoption, repeatable AI-ready corpora, supported extension rendering, and shared space plus page workflows from one read-only binary.
Free 14-day trial, paid plans from €99.99
Key Features
acs2md is built for space-scale export, supported macro rendering, synchronization, governance, and repeatable downstream use.
Full-Space Conversion
Export an entire Confluence space in one run, preserving hierarchy as folders and files.
Hierarchy, Links, and Extensions
Preserve the page tree as folders and files while rewriting internal Confluence links and rendering supported macros, cards, and attachments into portable output.
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 and Rich Conversion
Run page convert, get, count, and properties commands from the same binary while using the same extension engine for Draw.io, TOC, Page Tree, Children, inline cards, and attachments.
Progress, Read-Only, and Automation Ready
Use stderr progress bars and structured output in long-running jobs while every Confluence call remains read-only and safe for governed automation.
Supported Content
Space exports use the same engine, so large documentation estates keep structure and still expose clear fallbacks.
Images, media, and attachments
Carry inline images, Confluence media, PDFs, Office files, archives, Draw.io diagrams, and Roadmap Planner output with the exported tree.
Navigation and discovery macros
Render Table of Contents, Page Tree, Children, Recently Updated, labels, and blog listings into Markdown navigation across the space.
Governance and reporting macros
Resolve Contributors, Task Report, Content Report Table, Page Signatures, and QC macros during bulk conversion.
Cards and fallbacks
Resolve inline, embed, and block cards when possible; preserve unavailable macros as HTML comments for review.
See the reference docs for exact flags and defaults. API-backed extensions need credentials plus page or space context.
How It Works
Authenticate
Provide your Atlassian API token securely via environment variables.
Fetch Content
acs2md queries the read-only Confluence Cloud API and retrieves page content in ADF format.
Transform
The tool converts ADF, hierarchy, links, cards, attachments, and supported extensions into clean CommonMark Markdown with sync-aware output.
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 or a free 14-day trial key
- 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, extension flags, page commands, link rewriting, permissions, or space inventory guidance.
View DocumentationStart with one Confluence space
Use the getting started guide to validate access, activate a trial or paid license, and export a full Confluence space into portable Markdown.