confluence-export
/confluence-export
Search Confluence through its REST API, then export or refresh a page, subtree, space, or organisation as Markdown with cme. Use for finding Confluence pages, backups, migrations, local mirrors, or staging source pages in an Obsidian vault.
- Author
- yassimba ↗
- Repository
- loom ↗
- Licence
- Apache-2.0
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/search.py
What it does and when to use it
Search Confluence through its REST API, then export or refresh a page, subtree, space, or organisation as Markdown with cme. Use for finding Confluence pages, backups, migrations, local mirrors, or staging source pages in an Obsidian vault.
Original author description
Search Confluence through its REST API, then export or refresh a page, subtree, space, or organisation as Markdown with cme. Use for finding Confluence pages, backups, migrations, local mirrors, or staging source pages in an Obsidian vault.
How it works
- 1. Prepare access
- 2. Search
- 3. Set the export boundary
- 4. Export
- 5. Verify and hand off
SKILL.md preview
--- name: confluence-export description: Search Confluence through its REST API, then export or refresh a page, subtree, space, or organisation as Markdown with cme. Use for finding Confluence pages, backups, migrations, local mirrors, or staging source pages in an Obsidian vault. requires_bin: cme command: cme --- # Search and Export Confluence Search before export when the user does not have a page URL. Export the smallest requested scope to Markdown. A page, subtree, space, and organisation are progressively broader scopes. ## 1. Prepare access Check `cme version`. If it is missing, offer: ```sh loom add --tool confluence-markdown-exporter --dry-run ``` Show the install command without `--dry-run` and obtain confirmation before running it. Authentication is interactive. Ask the user to run this in their own terminal; tokens stay out of chat and command history: ```sh cme config edit auth.confluence ``` Use `cme <command> --help` as the current option reference. This step is complete when `cme` is available and the user confirms that authentication is configured. ## 2. Search When the user gives search terms instead of a URL, run the bundled helper: ```sh python3 <skill-directory>/scripts/search.py "integration guidelines" ``` Use `--space KEY` to limit the search to one space. Use `--site URL` only when the cme configuration contains several Confluence instances. The helper reads the credential file reported by `cme config path`, sends an official CQL content-search request, and prints page ids, titles, spaces, update times, and URLs as JSON. It never prints the username or token. Show the matching titles and URLs. Ask the user which result and scope to export when more than one reasonable match remains. This step is complete when one source URL is selected or when the user only requested search results. ## 3. Set the export boundary Collect the Confluence URL and choose one command: | Scope | Command | | -------------------- | --------------------------------------- | | Page | `cme pages <page-url>` | | Page and descendants | `cme pages-with-descendants <page-url>` | | Space | `cme spaces <space-url>` | | Organisation | `cme orgs <base-url>` | For a wiki export, resolve the selected vault and stage under `<vault>/inbox/confluence/<space>/`. Keep exported source material out of canonical wiki folders. Use a dedicated export directory containing no hand-edited files. CME overwrites exported pages and may remove local files when Confluence pages are deleted or moved. Confluence permissions are not reproduced on disk, so the destination must be at least as private as every page in scope. Confirm the destination before every export and obtain explicit confirmation for subtree, space, or organisation scope. This step is complete when scope, dedicated destination, and access boundary are explicit. ## 4. Export For a plain Markdown export, set the destination for the selected scope command: ```sh CME_EXPORT__OUTPUT_PATH="$DEST" cme pages "$SOURCE_URL" ``` For Obsidian staging, use per-command overrides so the user's persistent settings stay untouched: ```sh CME_EXPORT__OUTPUT_PATH="$DEST" \ CME_EXPORT__INCLUDE_DOCUMENT_TITLE=false \ CME_EXPORT__PAGE_BREADCRUMBS=false \ CME_EXPORT__PAGE_HREF=relative \ CME_EXPORT__ATTACHMENT_HREF=relative \ CME_EXPORT__PAGE_PROPERTIES_FORMAT=frontmatter \ CME_EXPORT__CONFLUENCE_URL_IN_FRONTMATTER=tinyui \ CME_EXPORT__PAGE_METADATA_IN_FRONTMATTER=true \ cme spaces "$SOURCE_URL" ``` Use the command selected in step 1 in place of `pages` or `spaces`. Relative links avoid ambiguous Obsidian links when pages share a title; use `wiki` links only when the user accepts that collision risk. Reusing the dedicated destination skips unchanged pages and cleans up files for deleted or moved pages. This step is complete when `cme` exits successfully and its summary has been captured. Continue to verification after any non-zero exit or reported failure, but treat the export as incomplete. ## 5. Verify and hand off Read the export summary and report: - scope and destination; - exported, unchanged, removed, and failed page counts; - exported, unchanged, removed, and failed attachment counts; - Markdown and attachment paths; - any unsupported macros or missing attachments reported by `cme`. A wiki export is complete when the source files are present under `inbox/confluence/` and every reported failure is visible. Stop after staging unless the user also asked for canonical ingestion or indexing.
Files in this package (3)
- SKILL.md 5 KB
- deps.yml 1 KB
- scripts/search.py 6 KB
Versions
The database has no other skills named confluence-export.
Database snapshot: 13.11.2026 · package version b5f13925270d (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90confluence-to-markdown
Move a Confluence space to Markdown files in a folder tree, with links between pages still working, using TransformPipe's free converter. Use when the user wants to migrate or back up Confluence to Markdown, Obsidian, a Git docs folder or a static site, or asks how to export a… - 100md-to-confluence
Push markdown files to Confluence - update existing pages or create new ones under a parent page. Use this skill whenever the user wants to publish markdown to Confluence, update a Confluence page from a local .md file, create new Confluence pages, or batch-create pages. Also… - 100confluence-documentation
Use when project-documentation preferences indicate Confluence export is needed, or when creating Confluence-formatted documentation pages. Covers XHTML storage format, macros (TOC, children, search, panels, code blocks, status badges), REST API page creation, and keeping repo… - 100confluence-to-md
Convert Confluence pages to clean GitHub-Flavored Markdown files. Use this skill whenever the user wants to pull a Confluence page into the local repo, convert Confluence content to markdown, download a spec from Confluence, or batch-convert multiple pages. Also triggers on… - 100confluence
Search and manage Confluence pages and spaces using CQL, read/create/update pages with Markdown support. Use when working with Confluence documentation. - 100confluence
Search, read and change Confluence Cloud. Find pages with CQL or plain text, read a page as Markdown, list spaces, the pages of a space and child pages, create and update pages, add comments. Use when the user asks what is written in Confluence, wants a wiki page summarised,…