How splieth/confluence2md works
confluence2md is a CLI and Python library for exporting Confluence content as Markdown. The main workflow loads and validates configuration, connects to Confluence, selects pages by ID, CQL, or space (optionally fetching children), then renders files with metadata and attachment images. A separate list-spaces command supports discovery. The source excerpts show CLI orchestration and renderer-to-attachment calls; README documents library use and image behavior. No filesystem store or additional pipeline is implied.
Main entry points: cli.py CLI commands · __init__.py Python API · renderer.py Markdown rendering · client.py Page selection
Components 15
Entry points
- CLI commands
src/confluence2md/cli.py - Python API
src/confluence2md/__init__.py
Configuration
- Config loading
src/confluence2md/config.py
Confluence access
- Authenticated client
src/confluence2md/client.py - Page selection
src/confluence2md/client.py - Page records
src/confluence2md/client.py - Space discovery
src/confluence2md/spaces.py - Attachment access
src/confluence2md/client.py
Markdown export
- Markdown rendering
src/confluence2md/renderer.py - Metadata output
src/confluence2md/renderer.py - Image processing
src/confluence2md/renderer.py - Markdown files
- Local image files
Other components
- User
- Confluence
Connections 22
- User → CLI commands: runs
README.md - User → Python API: calls
README.md - CLI commands → Config loading: loads
src/confluence2md/cli.py - CLI commands → Config loading: validates
src/confluence2md/cli.py - CLI commands → Authenticated client: connects
src/confluence2md/cli.py - CLI commands → Page selection: selects pages
src/confluence2md/cli.py - CLI commands → Space discovery: lists spaces
src/confluence2md/cli.py - CLI commands → Markdown rendering: exports pages
src/confluence2md/cli.py - Authenticated client → Confluence: authenticates
src/confluence2md/client.py - Page selection → Confluence: queries pages
src/confluence2md/client.py - Page selection → Page records: builds records
src/confluence2md/client.py - Space discovery → Confluence: lists spaces
src/confluence2md/spaces.py - Markdown rendering → Metadata output: formats metadata
src/confluence2md/renderer.py - Markdown rendering → Image processing: processes images
src/confluence2md/renderer.py - Image processing → Attachment access: fetches attachments
src/confluence2md/renderer.py - Image processing → Local image files: downloads images
src/confluence2md/renderer.py - Attachment access → Confluence: downloads data
src/confluence2md/client.py - Markdown rendering → Markdown files: writes Markdown
src/confluence2md/renderer.py - Python API → Config loading: exports API
src/confluence2md/__init__.py - Python API → Page selection: exports API
src/confluence2md/__init__.py - Python API → Markdown rendering: exports API
src/confluence2md/__init__.py - Python API → Space discovery: exports API
src/confluence2md/__init__.py