Markdown Exporter REST API

The Markdown Exporter REST API lets you export Confluence pages to Markdown from any external system — CI/CD pipelines, scheduled backups, content migration scripts, or custom integrations.

Authentication is handled via OAuth 2.0 (3LO) using a custom scope (export:markdown:custom) issued specifically for this app.

Endpoints

Endpoint	Use case
POST …/bulkExport	Export a space, or a page and all its descendants
POST …/singleExport	Export a single page only

Documentation Sections

• Getting Started — Enable the feature and complete OAuth setup
• Authentication — OAuth 2.0 flow and token rotation
• API Reference — Endpoints, request bodies, and response formats
• Examples — cURL, Node.js, and Python code samples
• Troubleshooting — Common errors and fixes

Quick Start

1. Enable App REST APIs — site admin enables this once in admin.atlassian.com
2. Create an OAuth 2.0 integration — add the export:markdown:custom scope at developer.atlassian.com
3. Authorize — complete the OAuth consent flow to receive an access token
4. Call the API:

curl --request POST \
  --url "https://api.atlassian.com/svc/confluence/{cloudId}/apps/{appId}_{envId}/singleExport" \
  --header "Authorization: Bearer {ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data '{"pageId": "123456"}' \
  > my-page.md

Support

• Support portal: https://yamuno.atlassian.net/servicedesk/customer/portals
• Email: [email protected]
• Marketplace: https://marketplace.atlassian.com/apps/102037374