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.
acp2md
Confluence Page to Markdown for exact page export, backup snapshots, compliance evidence, and AI-ready content preparation.
acp2md, short for Atlassian Confluence Page to Markdown, is built for precise page-level operations: controlled exports, page-level backup, evidence capture, migration analysis, docs-as-code handoff, and AI-ready document preparation.
Starting at €19.99 · Billed yearly through Lemon Squeezy
Key Features
acp2md is built for precise page export, retrieval, inspection, and controlled downstream use.
ID, Title, or URL Input
Export the exact page you need using the identifier your team already has.
Native Retrieval and Inspection
Fetch ADF or Storage output for debugging, migration engineering, page analysis, and custom downstream processing.
Per-Page Sync State
Use local .convert-sync-state.json tracking to refresh recurring exports without reprocessing unchanged pages.
Page Properties and Analysis
Count nodes and marks, inspect properties, and understand one page before migration, publishing, or AI ingestion.
Conversion Controls
Tune metadata, images, macro rendering, and conflict behavior for each export.
AI, Audit, and Retention Ready
Prepare authoritative documents for RAG pipelines, internal search, audit review, legal retention, and continuity workflows.
How It Works
Authenticate
Provide your Atlassian API token securely via environment variables.
Fetch Content
acp2md 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
acp2md
MMarkdown
- • Plain text
- • CommonMark/GFM
- • Git-friendly
- • Universal standard
Ideal Use Cases
Audit and Legal Evidence
Create controlled snapshots of high-value pages for audit support, legal hold preparation, or regulated record retention.
Runbooks and Continuity
Export critical operational runbooks into customer-controlled Markdown for continuity planning and backup.
Migration Design
Inspect one complex page before a broader migration to understand macros, formatting, and edge cases.
Page-Level Backup
Preserve exact copies of sensitive or strategic pages before edits, cleanup, or platform changes.
RAG Source Curation
Prepare authoritative single documents for chunking, embedding, and retrieval workflows.
Support and Incident Response
Work directly from a pasted Confluence URL when support or incident teams need one exact page immediately.
Getting Started
1. Prerequisites
- A valid acp2md license
- A Confluence Cloud domain and a user account with access to the target page
- An Atlassian API token and a terminal on macOS or Linux. Windows support is under development.
2. Generate an API Token
acp2md uses Atlassian API tokens for secure authentication:
- Visit Atlassian Account
- Click Create API Token
- Label it acp2md-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 acp2md with tool-specific Confluence environment variables:
4. Your First Conversion
Convert one Confluence page to Markdown and write it to a local file:
Replace 123456 with your real Confluence page ID. You can also use a title or a pasted Confluence URL.
5. Common Commands
Convert one page by ID:
Convert one page by URL:
Retrieve native ADF for debugging or migration analysis:
Need Help?
Use the detailed command reference when you need output control, sync behavior, native retrieval, or page analysis commands.
View Documentation