🚀 I built supabase-markdown — A tool to generate a full Supabase ERD across all schemas (because Visualizer can’t)

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)