Get Space Pages

The space get commands download all pages in a Confluence space to a local directory in their native format. This works like space convert, but without converting to Markdown: pages are saved as raw ADF JSON or Storage HTML.

Use this when the target workflow is engineering analysis, migration research, raw preservation, or custom downstream processing rather than immediate Markdown output.

Get by key


acs2md space get by-key SPACE_KEY [flags]

Aliases: key, k

Examples


# Download all pages in ADF JSON format (default)
acs2md space get by-key DOCS
 
# Download pages in Storage HTML format
acs2md space get by-key DOCS --format storage
 
# Specify a custom output directory
acs2md space get by-key DOCS --output-dir ./my-export/
 
# Download only archived pages
acs2md space get by-key DOCS --status archived
 
# Re-download only changed pages and remove local files for removed pages
acs2md space get by-key DOCS --output-dir ./native-export --sync
 
# Re-download only changed pages but keep removed pages locally
acs2md space get by-key DOCS --output-dir ./native-archive --incremental

Flags

Flag	Short	Default	Description
`--output-dir`	`-o`	`./output/<space-key>/`	Output directory
`--format`	`-f`	`atlas_doc_format`	Native format: `atlas_doc_format` or `storage`
`--status`	`-s`	`current`	Page status filter
`--conflict-resolution`	`-`	`overwrite`	Space conflict strategy
`--sync`	`-`	`false`	Track `.get-sync-state.json`, only re-download changed pages, and delete local files for removed pages. Mutually exclusive with `--incremental`.
`--incremental`	`-`	`true`	Track `.get-sync-state.json`, only re-download changed pages, and keep local files for removed pages. Mutually exclusive with `--sync`.

Get by ID


acs2md space get by-id SPACE_ID [flags]

Downloads all pages in a space using the numeric space ID.

Aliases: id

The flags and behavior mirror space get by-key.


acs2md space get by-id 123456 --format storage --output-dir ./export/

Progress reporting

Long-running native downloads display a real-time progress bar on stderr. That keeps stdout clean for redirected output while still giving operators visibility into the current page and overall completion.

space get shows page download progress
--resolve-users on space list still reports user-resolution progress separately
use the global --no-progress flag when you need a clean CI log or demo transcript

Progress output goes to stderr, so redirected files and piped stdout output do not get polluted by the progress bar.

Output structure

Pages are saved to a directory tree that mirrors the space hierarchy:


output/DOCS/
  getting-started.json
  api-reference.json
  guides/
    quickstart.json
    advanced-usage.json

When using --format storage, files are saved with an .html extension instead of .json.

If sync tracking is enabled, the output directory also contains .get-sync-state.json beside the downloaded content.

Sync and incremental mode

space get supports the same changed-only workflow shape as space convert, but it tracks native downloads with .get-sync-state.json instead of .convert-sync-state.json.

--sync re-downloads changed pages and removes local files when the source page disappears from Confluence
--incremental re-downloads changed pages but keeps local files when the source page disappears from Confluence

This makes space get suitable for both strict continuity mirrors and archive-oriented native preservation workflows.

When to use `space get` instead of `space convert`

use space get when you need native Confluence payloads
use space convert when you need portable Markdown
use both when a migration or troubleshooting workflow needs native inspection first and Markdown output second

Practical examples

Native preservation for migration engineering


acs2md space get by-key DOCS --format atlas_doc_format --output-dir ./native-docs

Repeatable native archive with changed-only refresh


acs2md space get by-key DOCS --format storage --output-dir ./native-archive --incremental