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 on Confluence Cloud: controlled exports, page-level backup, evidence capture, migration analysis, docs-as-code handoff, AI-ready document preparation, and supported extension rendering from the same read-only binary.
Free 14-day trial, paid plans from €19.99
Key Features
acp2md is built for precise page export, native retrieval, supported macro rendering, 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 Raw Formats
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.
Supported Extensions and Macros
Render Table of Contents, Page Tree, Children, inline cards, attachments, Draw.io, Roadmap Planner, and other supported Confluence content with safe fallbacks.
Read-Only, AI, Audit, and Retention Ready
Every command uses read-only GET requests, so you can prepare authoritative documents for RAG pipelines, internal search, audit review, legal retention, and continuity workflows without changing Confluence.
Supported Content
Common Confluence content renders directly, API-backed extensions resolve when credentials exist, and fallbacks stay visible instead of lossy.
Images, media, and attachments
Embed or link inline images, Confluence media, PDFs, Office files, archives, Draw.io diagrams, and Roadmap Planner output.
Navigation and discovery macros
Render Table of Contents, Page Tree, Children, Recently Updated, labels, and blog listings as Markdown anchors, lists, and links.
Governance and reporting macros
Resolve Contributors, Task Report, Content Report Table, Page Signatures, and QC macros into readable tables or inline values.
Cards and fallbacks
Resolve inline, embed, and block cards when possible; preserve unavailable macros as HTML comments.
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
acp2md queries the read-only Confluence Cloud API and retrieves page content in ADF format.
Transform
The tool converts ADF, cards, attachments, and supported extensions into clean CommonMark Markdown or native payloads with graceful fallbacks.
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 or a free 14-day trial key
- 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, extension flags, sync behavior, native retrieval, or page analysis commands.
View DocumentationStart with one Confluence page
Use the getting started guide to validate access, activate a trial or paid license, and export the exact page you need.