HN Showcase
Back to browse
GitHub Repository

Sync any Notion database to local markdown, MDX, or JSON files

9 starsTypeScript

Notion-to-site – sync any Notion database to local Markdown/MDX/JSON

by rashidae·May 8, 2026·5 points·0 comments
Visit ProjectView on HN

AI Analysis

●●SolidSolve My ProblemShip It

Better than Super.so for static sites because it outputs local files instead of hosting.

Strengths
  • •Handles complex Notion blocks like equations, synced blocks, and toggles without breaking.
  • •Built-in WebP conversion and image downloading removes the need for separate asset pipelines.
  • •Incremental sync tracks changed pages to avoid re-fetching the entire database every time.
Weaknesses
  • •Relies entirely on the Notion API rate limits; large databases will hit throttling quickly.
  • •No bidirectional sync; changes made to local files do not propagate back to Notion.
Target Audience

Static site developers, technical writers using Notion

Similar To

Super.so · notion-mdx · framer-notion

Post Description

Built this while syncing my own blog from Notion. Good alternative to paid options like Super.so.

Supports incremental sync, all Notion block types including equations and synced blocks, image download + WebP conversion, and adapters for Markdown, MDX, and JSON.

Works with Next.js, Astro, SvelteKit, and anything that reads files.

Similar Projects