Doc no. SK-404Rev 2026.09Sheet 2.2 of 4
U2
Notion Better Export
Exports a Notion workspace into an Obsidian vault with a true folder hierarchy, resolved relations and native Obsidian Bases.
Source on GitHub
$ nbe auto --dry-run
Block diagram
Characteristics
| Rate limit | 2.8 req/s proactive token bucket under Notion's 3.0 ceiling; honours Retry-After; circuit breaker after repeated failures |
|---|---|
| Hierarchy | Real parent/child folders; Page.md sits next to its Page/ folder; linked database views point at one canonical copy |
| Links | Two-pass resolution turns relation UUIDs into titles and [[wikilinks]] across CSVs and frontmatter |
| Views | Notion table, board, gallery and list views compiled to Obsidian .base files and embedded live |
| Safety | Atomic writes, single-instance lockfile, dry-run, refuses to write into system or home directories |
| Offline repair | nbe fix repairs raw UUIDs in an existing export without the API, with backups |
| Tests | 83 unit tests, all passing |