Skip to content
Skills Library
Documents & office · Conversion & formats

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.

Repository
loom ↗
Licence
Apache-2.0
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What to check before installing
  • 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. 1. Prepare access
  2. 2. Search
  3. 3. Set the export boundary
  4. 4. Export
  5. 5. Verify and hand off
Original SKILL.md headings · 111 lines, 604 words
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,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.