ntnsync synchronizes Notion pages to a local git repository as markdown files.
| Document | Description |
|---|---|
| CLI Commands | All commands with flags, examples, and workflows |
| File Architecture | Directory structure, state files, registries, queue system |
| Markdown Conversion | How Notion blocks are converted to markdown |
| Development | Logging guidelines, code organization, building |
ntnsync uses a folder-based organization where pages are grouped into named folders (e.g., tech, product). Each folder contains root pages and their nested children.
Sync workflow:
- Configure root pages in
root.md pull- Queue pages that changed since last pullsync- Process the queue, download pages, write markdown
Key features:
- Stable file paths (don't change on rename)
- Git-backed storage with atomic commits
- Incremental sync with change detection
- Database support with child page listings