sidenotions keeps your local files in sync with Notion.

what gets synced

  • pages become markdown files
  • databases become folders with one file per row
  • nested pages become folder hierarchies
  • images and files are downloaded locally

file format

each page becomes a markdown file with frontmatter:

---
notion_page_id: abc123def
notion_last_sync: 2026-01-14T12:00:00Z
---

# Page Title

your content here...

sync direction

currently one-way: Notion to local files.

  • read: instant (files are local)
  • changes in Notion: synced automatically
  • local edits: not synced back (yet)

when sync happens

  • initial: full sync when you connect
  • ongoing: webhook-triggered when pages change in Notion
  • manual: pull to refresh in the app

sync status

the app shows sync status for each workspace:

  • synced: up to date
  • syncing: download in progress
  • error: something went wrong (check logs)