Confluence¶

atlcli provides bidirectional sync between local markdown files and Confluence pages.

Overview¶

Work with Confluence using familiar Git-like workflows:

# Initialize a local directory
atlcli wiki docs init ./team-docs --space TEAM

# Pull pages from Confluence
atlcli wiki docs pull ./team-docs

# Edit locally, then push changes
atlcli wiki docs push ./team-docs

# Watch for changes
atlcli wiki docs sync ./team-docs --watch

Key Features¶

• Bidirectional Sync - Pull from Confluence, push local changes
• Conflict Detection - Warns when both local and remote changed
• Markdown Format - Write in markdown, atlcli handles conversion
• Macro Support - Use Confluence macros like info panels and TOC
• Page Templates - Create pages from reusable templates

Quick Start¶

1. Initialize Directory¶

atlcli wiki docs init ./docs --space TEAM

2. Pull Pages¶

atlcli wiki docs pull ./docs

3. Edit Files¶

Files are standard markdown with YAML frontmatter:

---
id: "12345"
title: "API Documentation"
space: "TEAM"
---

# API Documentation

Your content here...

4. Push Changes¶

atlcli wiki docs push ./docs

Sections¶

• Sync - Bidirectional sync, conflict handling, daemon mode
• Pages - Create, update, delete, move, sort pages
• Spaces - Space operations
• Templates - Page templates with variables
• Macros - Info panels, notes, warnings, TOC
• Attachments - Sync images and files
• File Format - Frontmatter and directory structure