Hey folks 👋
If you’ve used Supabase Visualizer, you know it’s great — but it has one limitation:
❌ You can only view one schema at a time.
For small projects that’s fine, but once your app grows and you have:
public
storage
auth
graphql_public
custom schemas
…It becomes impossible to see the entire database structure at one glance.
I needed a “global view” badly.
So I built it.
🔥 Introducing supabase-markdown
GitHub: (https://github.com/idevbrandon/supabase-markdown)
NPM: pnpm add -D supabase-markdown
🧠 What problem does it solve?
Supabase Visualizer can only display one schema at a time, which makes it hard to understand the true structure of your database.
I wanted:
✔ One file
✔ One diagram
✔ Every table
✔ Across every schema
✔ All relationships shown together
Now you can get a single unified ERD like:
erDiagram
accounts ||–o{ posts : account_id
posts ||–o{ post_hashtags : post_id
hashtags ||–o{ post_hashtags : hashtag_id
profiles ||–|| accounts : id
storage.objects ||–o{ public_posts : image_id
All in one place. No clicking through schemas.
🛠️ How it works
Supabase already gives you a full schema representation via:
supabase gen types typescript
That file contains:
tables
columns
enums
relationships
foreign keys
schemas
supabase-markdown parses that file and outputs:
✔ Full Markdown documentation
✔ Combined cross-schema ERD
✔ Grouped tables by schema
✔ Fully static output (perfect for GitHub, Notion, docs sites)