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: acs2md

Single-Page Export

acp2md

Atlassian Confluence Page to Markdown for exact page-level export and inspection.

acp2md, short for Atlassian Confluence Page to Markdown, is built for precise page-level operations: controlled exports, evidence capture, migration analysis, and AI-ready document preparation.

Explore FeaturesGet Started
$ acp2md page convert by-id 123456 -o ./page.md
→ Retrieving page metadata...
→ Downloading ADF payload...
→ Rendering Markdown output...
✓ Exported ./page.md
$_
Powerful Capabilities

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.

Simple & Reliable

How It Works

1

Authenticate

Provide your Atlassian API token securely via environment variables.

2

Fetch Content

acp2md 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

acp2md

MMarkdown

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

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.

Quick Setup

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, Linux, or Windows

2. Generate an API Token

acp2md uses Atlassian API tokens for secure authentication:

  1. Visit Atlassian Account
  2. Click Create API Token
  3. Label it acp2md-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 acp2md with tool-specific Confluence environment variables:

export ACP2MD_CONFLUENCE_DOMAIN="your-domain.atlassian.net"
export ACP2MD_CONFLUENCE_USERNAME="email@example.com"
export ACP2MD_CONFLUENCE_API_TOKEN="your-api-token"

4. Your First Conversion

Convert one Confluence page to Markdown and write it to a local file:

$ acp2md page convert by-id 123456 -o ./page.md

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:

acp2md page convert by-id <PAGE_ID> -o ./docs/page.md

Convert one page by URL:

acp2md page convert by-url "https://your-domain.atlassian.net/wiki/..." -o ./docs/page.md

Retrieve native ADF for debugging or migration analysis:

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

Need Help?

Use the detailed command reference when you need output control, sync behavior, native retrieval, or page analysis commands.

Read the Documentation