confluence-export

Search Confluence via REST API and export pages, spaces, or organisations to Markdown.

9|Updated Jul 17, 2026
One-click install
npx skills add https://github.com/Yassimba/loom --skill confluence-export-yassimba
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: confluence-export
Source: https://github.com/Yassimba/loom/tree/main/skills/confluence-export
Command: npx skills add https://github.com/Yassimba/loom --skill confluence-export-yassimba

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes scripts (resource) components.

What problem does it solve? Confluence content is locked behind a web UI, making backups, migrations, and offline access tedious. This Skill searches Confluence through its REST API and exports pages, subtrees, spaces, or entire organisations as local Markdown files using the cme tool. ## Core Features & Use Cases - Credential-safe search: A bundled Python helper runs CQL content searches using the credentials stored by cme, returning page IDs, titles, spaces, and URLs as JSON without ever printing tokens. - Scoped exports: Export a single page, a page with descendants, a whole space, or an entire organisation, with explicit confirmation required for broader scopes. - Obsidian staging: Stage exports under a vault's inbox/confluence folder with frontmatter metadata, relative links, and page properties formatted for wiki ingestion. - Use Case: You need a local mirror of your team's engineering space before a platform migration. Search for the space, confirm the destination, and export it as Markdown with attachments, then review the summary of exported, unchanged, and failed pages. ## Quick Start Use the confluence-export skill to find the page about integration guidelines and export it with its descendants as Markdown.

Frequently Asked Questions about confluence-export

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I export a Confluence page to Markdown?โ–ผ

Run cme pages with the page URL and set CME_EXPORT__OUTPUT_PATH to your destination directory. For broader scopes, use pages-with-descendants, spaces, or orgs commands with the corresponding URL.

How do I search Confluence pages from the command line?โ–ผ

Use the bundled search.py helper with a query string, optionally adding --space to limit results to one space key. It sends a CQL content-search request to the Confluence REST API and prints matching page IDs, titles, and URLs as JSON.

Can I export Confluence pages into an Obsidian vault?โ–ผ

Yes, stage exports under the vault's inbox/confluence/<space>/ folder using per-command environment overrides. These set frontmatter page properties, relative links, and disable breadcrumbs so the files work as Obsidian source material.

Does the Confluence search script expose my API token?โ–ผ

No, the helper reads credentials from the cme configuration file and never prints the username or token. Authentication is configured interactively with cme config edit auth.confluence so tokens stay out of chat and shell history.

What are the limitations of exporting Confluence to Markdown?โ–ผ

Confluence permissions are not reproduced on disk, so the destination must be at least as private as every exported page. Some macros may be unsupported, and cme may remove local files when pages are deleted or moved on the server.