Live collaborative notes
meeting minutes, brainstorms, classes
// official site: hedgedoc.org ↗
PRODUCTIVITY · PRO TIER
HedgeDocpro
HedgeDoc is a real-time collaborative Markdown editor — multiple users edit the same document simultaneously in browser, with revision history, public sharing, MathJax + Mermaid diagrams. Fork of HackMD (formerly CodiMD) with continued open-source commitment.
// What it is
A closer look.
HedgeDoc is a real-time collaborative Markdown editor — multiple users edit the same document simultaneously in browser, with revision history, public sharing, MathJax + Mermaid diagrams. Fork of HackMD (formerly CodiMD) with continued open-source commitment.
// Use cases
What it's for.
Concrete scenarios where teams pick HedgeDoc over the SaaS alternative.
Pair programming docs
shared scratch pad with code blocks
Public sharing
link-based read-only or editable docs
Markdown publishing
single-file blog posts
Slide presentations
reveal.js mode for slides
// Who it's for
Built for these teams.
If your team profile matches one of these, HedgeDoc is a strong fit out of the box.
Engineering teams
writing collaborative technical docs
Educators / students
taking shared class notes
OSS communities
drafting docs collaboratively
Privacy-bound orgs
rejecting HackMD/Notion cloud
Writers / journalists
collaborating on articles
// Differentiators
Why teams pick HedgeDoc.
When evaluating self-hosted options for this category, here are the dimensions on which HedgeDoc consistently lands above the alternatives.
- ✓AGPLv3 — fully open
- ✓Real-time multi-user — WebSocket-based, no save conflicts
- ✓Markdown-native — content portable
- ✓Math + diagrams — MathJax + Mermaid + GraphViz built in
- ✓Active development — community-driven fork
- ✓i18n — 20+ language UIs
// Integrations
Connects to.
The stack you'll plug HedgeDoc into — services, protocols, and adjacent apps in the BluixApps catalog.
◇
Authentication
local + OAuth (GitHub, GitLab, Google, Facebook, custom OIDC) + LDAP + SAML
◈
Storage
Postgres (primary), MariaDB / MySQL / SQLite
◆
Export
Markdown, HTML, PDF (via headless Chrome), reveal.js slides
▣
Real-time
Socket.IO for multi-cursor editing
▦
Embeds
YouTube, Vimeo, Gist, Slideshare
▩
Diagrams
Mermaid, GraphViz, PlantUML
▼
API
REST + WebSocket
// Adoption & deployment
Notable users & community
- 5k+ GitHub stars
- Active community on Matrix + GitHub
- Backed by community after CodiMD → HedgeDoc rename
- Featured in OSS doc collaboration guides
- Standard tool in privacy-bound collaborative writing
What we ship
- Docker stack: HedgeDoc 1.10 + Postgres 17
- Auto-generated session secret + DB password
- Persistent volumes for Postgres + uploads
- Port 8089 exposed (mapped from 3000)
- HTTPS via Let's Encrypt reverse proxy
- Free URL mode enabled (custom slugs)
- Backup hook covers Postgres + uploads
// Tips & operations
Run it properly.
Operational guidance from running this in production — what to lock down, what surprises people.
// PERFORMANCE
Postgres for production
SQLite ok for small / personal
// SECURITY
Session secret in env
sign-in tokens; protect this
// OPERATIONS
OAuth setup
needed for team workflows
// RELIABILITY
Free URL mode
allow custom slugs (security trade-off, careful)
// DEPLOYMENT
Backup Postgres + uploads
both essential
// SCALING
HTTPS production
required for Service Worker features
512
// min ram (MB)
4
// min disk (GB)
8089
// access port
http
// protocol
pro
// bluixapps tier
// Alternatives in Productivity
Compare with
Project resources
Official sitehedgedoc.org ↗