HedgeDoc - Markdown-Dokumente gemeinsam in Echtzeit bearbeiten

≈ 1 min
notizenkommunikation

HedgeDoc - Markdown-Dokumente gemeinsam in Echtzeit bearbeiten

HedgeDoc ist eine selbstgehostete Kollaborationsplattform für Markdown-Dokumente mit Echtzeit-Mehrbenutzerbearbeitung direkt im Browser.

Was ist HedgeDoc?

HedgeDoc (ehemals CodiMD) ermöglicht es, Markdown-Dokumente gleichzeitig mit mehreren Personen zu bearbeiten, ähnlich wie Google Docs — nur vollständig selbstgehostet und ohne Cloud-Abhängigkeit. Änderungen werden in Echtzeit synchronisiert, und das fertige Dokument kann als HTML, PDF oder Folien (via Reveal.js) exportiert werden. HedgeDoc eignet sich besonders für Team-Meetings, technische Dokumentationen und gemeinsame Notizen.

Voraussetzungen

  • Docker 20.10+ / Docker Compose
  • PostgreSQL-Datenbank (im Stack enthalten)

Compose-Beispiel

services:
  hedgedoc:
    image: hedgedoc/hedgedoc:latest
    container_name: hedgedoc
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - CMD_DB_URL=postgres://hedgedoc:secret@db:5432/hedgedoc
      - CMD_DOMAIN=localhost
      - CMD_PROTOCOL_USESSL=false
    depends_on:
      - db

  db:
    image: postgres:16-alpine
    container_name: hedgedoc-db
    restart: unless-stopped
    volumes:
      - ./db-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=hedgedoc
      - POSTGRES_PASSWORD=secret
      - POSTGRES_DB=hedgedoc

Hinweise

  • CMD_DOMAIN muss auf die tatsächlich erreichbare Domain oder IP-Adresse gesetzt werden, da WebSocket-Verbindungen sonst fehlschlagen.
  • Für den Produktionseinsatz sollte CMD_PROTOCOL_USESSL=true gesetzt und ein Reverse-Proxy mit TLS vorgeschaltet werden.
  • Gäste können standardmäßig neue Dokumente erstellen; dieses Verhalten lässt sich mit CMD_ALLOW_ANONYMOUS=false einschränken.
  • Dokumente sind über kurze URLs zugänglich — eine Freigabe erfordert lediglich das Teilen des Links.