local-mirror-format

Local Confluence Mirror — Storage Structure and Format

This rule describes the local storage format for Confluence pages exported by the ConfluencePageExporter tool. Use it to correctly read, edit, and create pages in the local mirror.

Directory Hierarchy

Pages are stored as a folder tree that mirrors the Confluence page hierarchy:

<output-dir>/
  Root Page/
    index.html
    .id12345_7
    image.png
    spec.pdf
    Child Page A/
      index.html
      .id23456_3
    Child Page B/
      index.html
      .id34567_1
      Nested Page/
        index.html
        .id45678_2

• Folder name = Confluence page title (filesystem-unsafe characters are replaced)
• Folder nesting = parent-child relationships between pages
• One folder = one Confluence page

Page Folder Contents

Each page folder contains three types of files:

index.html — Page Content

The index.html file contains the page body in Confluence Storage Format — the body.storage.value field from the Confluence REST API.

This is not regular HTML. Storage format is an XHTML subset with Confluence-specific namespaces and macros.

.id_ — Identity Marker

A file named like .id12345_7, where:

• 12345 — the page identifier (pageId) in Confluence
• 7 — the page version number on the server at the time of last sync

The marker is used for:

• Stable mapping of a local folder to a Confluence page (even after renames)
• Detecting whether the page was updated on the server (version comparison)
• Conflict tracking (LastWriteTimeUtc of the marker = timestamp of the last sync)

Marker body. The file content is a small JSON object captured at sync time:

{"title":"Original Page Title","space":"SPACEKEY"}

• title — the page's original (unsanitised) title, so special characters lost in the folder name can be restored on upload.
• space — the key of the space the page belongs to. A Confluence page tree always lives in a single space; this records which one, so trees from different spaces can sit side by side and be synced without specifying the space each time.