Confluence to Obsidian

Confluence to Obsidian

Export Confluence pages and whole spaces into Obsidian vaults: native callouts, wikilinks, tags from labels, image sidecar files, and a changed-only sync that keeps the vault current.

acp2md and acs2md read Confluence Cloud through its API and write Markdown that Obsidian treats as its own. One flag, --obsidian, switches on the whole preset; every other conversion feature — macros, attachments, link rewriting, front matter — stays available.

What the Obsidian preset does

Each item is a conversion choice you would otherwise fix by hand in the vault.

Native callouts

Confluence info, note, warning, success and error panels become Obsidian callouts, so a runbook reads the same in both places. Without the preset they render as GitHub alerts, which Obsidian also displays.

Wikilinks between pages

Links to other Confluence pages become [[wikilinks]] the vault resolves, and heading links use anchors Obsidian understands instead of GitHub-style slugs.

Labels as tags

Confluence labels become inline #tags and front-matter tags that Obsidian reads as Properties, so the tag pane and search index the vault from day one.

Images as sidecar files

Images are saved beside the note under attachments/ and linked relatively instead of embedded as base64, which Obsidian cannot render; an image reused across pages is stored once.

A vault that mirrors the space

acs2md keeps the page tree as folders, rewrites internal links to relative links, and converts several pages at once, so a thousand-page space becomes a navigable vault in one run.

Changed-only refresh

Run the export again with --sync and only the pages that changed are reconverted; pages deleted in Confluence leave the vault, or stay with --incremental.

Which tool for which vault

Use acp2md to drop one Confluence page into an existing vault as a note. Use acs2md when the vault is the space.

Available Now

acp2md

acp2md converts one page by ID, title or pasted URL into a note, with the Obsidian preset applied.

  • One command: acp2md page convert by-id ID --obsidian -o ./vault/note.md
  • Pick panel style, wikilinks, inline tags and media dimensions individually when the full preset is too much.
  • Count nodes and marks first to see what a complex page will become.

Available Now

acs2md

acs2md exports a whole space as a vault whose folders follow the page tree, then keeps it in sync.

  • One command: acs2md space convert by-key KEY --obsidian --output-dir ./vault
  • Internal links are rewritten to relative links the vault resolves; four pages convert at once by default, paced by Confluence's own rate limits.
  • Re-run with --sync for a changed-only refresh, and the vault follows the space.

Why teams move Confluence into Obsidian

Obsidian gives a documentation set what a browser tab cannot: offline access, local search, graph view and plain files in Git.

Team documentation as a personal knowledge base

Pull the spaces you work from into one vault, link them with your own notes, and refresh them with --sync without redoing your links.

Offline runbooks

On-call engineers open procedures, diagrams and attachments from the vault when the network, or Confluence, is the thing that is down.

Migration off Confluence

Export the whole estate as a vault, review what rendered and what fell back to HTML comments, and decide what to keep before the subscription ends.

Local-first AI assistants

A vault of clean Markdown with front matter is ready for local embedding and retrieval pipelines without sending a page anywhere.

Pick the tool that matches your vault

One page or the whole space: both use the same engine, the same preset and the same licence model.