Erste Schritte

Du hast ein managed HedgeDoc bei server.camp bestellt – herzlichen Glückwunsch! HedgeDoc ist ein kollaborativer Markdown-Editor: Mehrere Personen können gleichzeitig an einem Dokument schreiben, sehen Änderungen in Echtzeit und teilen das Ergebnis mit einem einfachen Link – kein Account nötig für Gäste. Diese Anleitung richtet sich an Freelancer, kleine bis mittlere Unternehmen und Vereine, die schnelle, unkomplizierte Zusammenarbeit an Texten brauchen – ohne Google Docs.

Für schnelle Notizen und gemeinsame Dokumente greifen viele auf Google Docs zurück – aber das bedeutet: Daten auf US-Servern, Abhängigkeit von einem Konzern und datenschutzrechtliche Graubereiche bei vertraulichen Inhalten.

HedgeDoc bietet dasselbe Echtzeit-Erlebnis beim gemeinsamen Schreiben, läuft aber auf deiner eigenen Infrastruktur bei server.camp in Deutschland – DSGVO-konform und ohne Abhängigkeit von Google oder Microsoft.

Typische Einsatzszenarien:

• Meeting-Protokolle gemeinsam live mitschreiben – alle Teilnehmer ergänzen gleichzeitig
• Brainstorming-Sessions strukturiert festhalten – Ideen sofort in Stichpunktlisten
• Projektbriefings schnell teilen – Link an Kunde oder Kollege schicken, fertig
• Technische Dokumentation im Markdown-Format – mit Codeblöcken und Diagrammen
• Shared Agenda vor Meetings – alle können vorab Punkte eintragen
• Präsentationen direkt aus Markdown erstellen – ohne PowerPoint
• Vereinsprotokolle – Vorstandssitzung live mitschreiben, danach per Link teilen
• Checklisten und Aufgabenlisten – To-Do-Listen mit Checkboxen
• Diagramme und Visualisierungen – Flowcharts, Gantt-Diagramme, Sequenzdiagramme direkt im Dokument

HedgeDoc arbeitet mit Notizen – das sind einzelne Dokumente. Jede Notiz bekommt automatisch eine URL. Wer diese URL hat, kann die Notiz lesen (und je nach Einstellung auch bearbeiten).

Das Besondere: Mehrere Personen können gleichzeitig an derselben Notiz schreiben. Änderungen erscheinen in Echtzeit bei allen Anderen - ideal für Meetings, Brainstormings oder gemeinsame Dokumentation.

Notizen werden in Markdown geschrieben – einer leichtgewichtigen Auszeichnungssprache, die sich leicht lesen und schreiben lässt.

Jede Notiz hat Berechtigungseinstellungen, die festlegen, wer sie lesen oder bearbeiten darf. Du kannst eine Notiz so einstellen, dass sie öffentlich zugänglich ist (mit Link), nur eingeloggte Nutzer deiner Instanz Zugriff haben oder dass sie komplett privat bleibt.

Danke für die Korrektur! Hier die überarbeitete Tabelle:

Ersteller = Besitzer der Notiz

Der Ersteller einer Notiz ist automatisch der Besitzer und hat volle Kontrolle über die Berechtigungen. Er kann jederzeit die Freigabeeinstellungen ändern, um die Sichtbarkeit und Bearbeitungsrechte anzupassen.

Markdown ist in wenigen Minuten gelernt. Du schreibst normalen Text und fügst einfache Zeichen hinzu, um Formatierungen zu erzeugen. HedgeDoc zeigt links den Editor und rechts die formatierte Vorschau – du siehst sofort, was passiert.

**Fetter Text** wird mit doppelten Sternchen markiert
*Kursiver Text* wird mit einfachen Sternchen markiert
~~Durchgestrichener Text~~ mit doppelten Tilden
`Code im Fließtext` mit Backticks

# Überschrift 1 (größte)
## Überschrift 2
### Überschrift 3
#### Überschrift 4

- Stichpunkt 1
- Stichpunkt 2
  - Eingerückter Unterpunkt
  - Noch ein Unterpunkt

1. Nummerierte Liste
2. Zweiter Punkt
3. Dritter Punkt

- [ ] Aufgabe noch offen
- [x] Aufgabe erledigt

[Linktext](https://server.camp)

![Bildbeschreibung](https://example.com/bild.png)

Bilder aus der Zwischenablage lassen sich einfach einfügen

Um ein Bild aus der Zwischenablage einzufügen, kannst du im Editor einfach Strg + V drücken. HedgeDoc lädt das Bild automatisch hoch und fügt den Markdown-Code mit der URL ein.

> Dies ist ein Zitat oder ein hervorgehobener Hinweis.
> Es kann auch über mehrere Zeilen gehen.

| Name     | Rolle      | Abteilung  |
|----------|------------|------------|
| Lisa     | Teamlead   | Vertrieb   |
| Max      | Entwickler | IT         |
| Anna     | Vorstand   | Finanzen   |

```javascript
function greet(name) {
  return `Hallo ${name}!`;
}
```

HedgeDoc unterstützt Syntax-Highlighting für dutzende Programmiersprachen – einfach den Sprachnamen nach den drei Backticks angeben.

---

Markdown muss man nicht auswendig können

HedgeDoc zeigt links den Editor und rechts die formatierte Vorschau. Probiere einfach aus und schau auf die rechte Seite, was passiert. Zusätzlich bietet die Toolbar über dem Editor Buttons für die gängigsten Formatierungen – wie in einer normalen Textverarbeitung.

1. Auf der Startseite von HedgeDoc auf “Neue Notiz” klicken
2. Der Editor öffnet sich – links schreiben, rechts das Ergebnis sehen
3. HedgeDoc speichert automatisch – kein manuelles Speichern nötig

Über die Buttons im Editor kannst du zwischen drei Ansichten wechseln:

Oben rechts findest du die Teilen-Funktion:

• Bearbeitungslink – wer diesen Link hat, kann mitschreiben
• Leseansicht (Publish-Link) – wer diesen Link hat, sieht nur das formatierte Dokument
• Slide-Modus – das Dokument wird als Präsentation angezeigt

Einfach den Link kopieren und verschicken – kein Login nötig für externe Personen (bei entsprechender Berechtigungseinstellung).

Bei jeder Notiz kannst du über das Schlosssymbol die Berechtigungen festlegen:

Vertrauliche Inhalte schützen

Setze die Berechtigung auf “Eingeschränkt” oder “Privat”, wenn du sensible Inhalte (Budgets, Personalthemen, Kundendaten) besprichst. So können nur angemeldete Nutzer auf deiner Instanz das Dokument öffnen – der bloße Link reicht dann nicht mehr.

HedgeDoc kann Diagramme direkt aus Text generieren – kein externes Tool nötig. Du beschreibst das Diagramm in einer speziellen Syntax, und HedgeDoc rendert es automatisch.

```mermaid
graph TD
    A[Kunde schickt Anfrage] --> B{Anfrage-Typ?}
    B -->|Support| C[Zammad-Ticket]
    B -->|Vertrieb| D[CRM-Eintrag]
    C --> E[Agent bearbeitet]
    D --> F[Vertrieb kontaktiert]
```

Mermaid unterstützt viele Diagrammtypen: Flowcharts, Sequenzdiagramme, Gantt-Diagramme, Klassendiagramme, ER-Diagramme und Pie-Charts.

Mermaid für die meisten Fälle

Für die meisten Anwendungsfälle reicht Mermaid aus – es ist am vielseitigsten und am besten dokumentiert. Die Mermaid-Dokumentation bietet viele Beispiele zum Nachbauen.

HedgeDoc kann mathematische Formeln mit LaTeX-Syntax darstellen:

Inline: $E = mc^2$

Block:
$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$

Ideal für technische Dokumentation, wissenschaftliche Notizen oder Kalkulationen.

HedgeDoc kann externe Inhalte direkt in Notizen einbetten – einfach den Link einfügen:

• YouTube-Videos – Link einfügen, Video wird eingebettet angezeigt
• Vimeo-Videos – analog zu YouTube
• GitHub Gists – Code-Schnipsel direkt anzeigen
• SlideShare – Präsentationen einbetten
• PDF-Dateien – PDF-Viewer direkt im Dokument

Füge [TOC] in deine Notiz ein, und HedgeDoc generiert automatisch ein Inhaltsverzeichnis aus allen Überschriften. Besonders nützlich für längere Dokumente.

Am Anfang einer Notiz kannst du YAML-Metadaten angeben:

---
title: Meeting-Protokoll 22.02.2026
tags: meeting, vorstand, Q1-2026
---

Tags helfen beim Wiederfinden von Notizen über die Suchfunktion.

HedgeDoc kann Markdown-Notizen als Präsentationen darstellen – powered by reveal.js. Das Trennzeichen --- (drei Striche in einer eigenen Zeile) trennt Folien voneinander:

---
title: Quartalsbericht Q1
slideOptions:
  theme: white
---

# Quartalsbericht Q1 2026

Firma GmbH – Februar 2026

---

## Umsatzentwicklung

- Januar: 120.000 €
- Februar: 135.000 €
- Trend: **+12% zum Vorjahr**

---

## Nächste Schritte

1. Neue Website launchen
2. Vertrieb erweitern
3. Support-Team aufbauen

---

## Fragen?

Kontakt: team@firma.de

Klicke oben rechts auf das Präsentationssymbol, und HedgeDoc zeigt die Notiz als Slideshow.

Über die YAML-Metadaten am Anfang kannst du das Erscheinungsbild anpassen:

Präsentationen ohne PowerPoint

Für schnelle Projekt-Updates, Team-Briefings oder Vereins-Vorstellungen sind HedgeDoc-Präsentationen ideal: Du schreibst den Inhalt in Markdown (schneller als Folien gestalten), teilst den Link, und alle können die Präsentation im Browser sehen – ohne PowerPoint, ohne Datei-Anhänge, ohne Kompatibilitätsprobleme.

HedgeDoc speichert den Bearbeitungsverlauf. Unter “Versionen” (oben rechts im Editor) kannst du:

• Frühere Stände des Dokuments ansehen
• Änderungen zwischen Versionen vergleichen
• Zu einem früheren Stand zurückspringen

Das ist besonders wertvoll, wenn bei einer gemeinsamen Session etwas versehentlich gelöscht wurde.

Alle eigenen Notizen findest du nach dem Einloggen unter “Meine Notizen”. Du kannst Notizen:

• Als Favoriten markieren (Stern-Symbol) für schnellen Zugriff
• Nach Tags filtern
• Nach Titel oder Erstelldatum sortieren

Index-Notiz für Teams

Lege eine zentrale Index-Notiz an, die als Startseite dient und Links zu allen wichtigen Notizen enthält – Meeting-Protokolle nach Datum, Projektbriefings nach Projekt, wiederkehrende Agendas. Pinne diese Notiz an und teile den Link im Team (z. B. als Lesezeichen oder in Mattermost). So findet jeder sofort die richtige Notiz.

Da HedgeDoc Notizen standardmäßig mit zufälligen URLs erstellt, hilft eine einheitliche Benennung im Titel:

HedgeDoc kann Notizen in verschiedene Formate exportieren:

Markdown als universelles Format

Markdown-Dateien können fast überall weiterverwendet werden: als README oder Wiki-Seite in GitLab, als Seite in WikiJS als Dokumentation in Nextcloud, oder sogar als Grundlage für eine Website (Hugo, Jekyll). Ein in HedgeDoc geschriebenes Dokument ist nie in einem proprietären Format gefangen.

HedgeDoc unterstützt verschiedene Login-Methoden:

• Lokale Accounts – Benutzer direkt in HedgeDoc anlegen
• SSO über Authentik oder andere OIDC-kompatible Identity-Provider – wenn du z.B. ein Authentik bei server.camp nutzt, können sich Mitarbeitende mit ihrem zentralen Konto anmelden

Für externe Personen (Kunden, Projektpartner, Vereinsmitglieder ohne Account) reicht oft der Bearbeitungslink – sie können sofort mitschreiben, ohne sich zu registrieren. Setze die Berechtigung der Notiz entsprechend auf “Frei”.

Tipp für Freelancer: Nutze HedgeDoc als schnelles Notiz- und Entwurfswerkzeug. Es startet sofort (ein Klick → neues Dokument), braucht keine App-Installation und ist über den Browser erreichbar. Für die dauerhafte Ablage exportierst du fertige Dokumente nach Markdown und speicherst sie in WikiJS, Nextcloud oder GitLab.

Onboarding-Tipp: Erstelle eine HedgeDoc-Notiz “Team-Konventionen” mit: Namenskonventionen für Notizen, Link zur Index-Notiz, Markdown-Kurzreferenz, Hinweis auf Berechtigungen. Neue Mitarbeitende lesen diese Notiz und wissen sofort, wie HedgeDoc im Team genutzt wird.

Tipp für Vereine: HedgeDoc ist ideal als Protokoll-Tool. Die Kombination aus Echtzeit-Bearbeitung und Link-Sharing passt perfekt zur Vereinsarbeit: Während der Sitzung schreiben 2–3 Personen mit, nach der Sitzung wird der Leselink an alle Mitglieder verteilt. Kein Formatierungs-Aufwand, kein E-Mail-Ping-Pong mit verschiedenen Versionen.

Exportiere fertige Dokumente als Markdown und importiere sie in WikiJS für die dauerhafte Dokumentation. HedgeDoc eignet sich hervorragend als Entwurfs- und Kollaborationsphase (Notizzettel) – WikiJS als strukturierte Wissensdatenbank (Aktenordner).

Teile HedgeDoc-Links direkt in Mattermost-Channels. Typische Workflows:

• Vor dem Meeting: Agenda-Link im Channel posten
• Nach dem Meeting: Leselink zum Protokoll teilen
• Für Projekte: Link zur Projektdokumentation im Channel-Header anheften

Exportiere fertige Dokumentation als Markdown und importiere sie in GitLab-Wikis oder als README.md in Repositories. HedgeDoc eignet sich hervorragend als Entwurfs- und Kollaborationsphase – GitLab als dauerhafte Ablage.

Speichere exportierte Markdown-Dateien in Nextcloud oder Seafile für die langfristige Archivierung. HedgeDoc ist ideal zum gemeinsamen Schreiben, Nextcloud/Seafile für die strukturierte Ablage.

Verbinde HedgeDoc mit Authentik für zentrales Login. Mitarbeitende melden sich mit einem Konto an, Onboarding und Offboarding werden zentral gesteuert.

Falls du Unterstützung bei der Einrichtung brauchst oder SSO mit Authentik verbinden möchtest, erreichst du uns jederzeit unter support@server.camp. Wir helfen dir gerne!

Häufig gestellte Fragen zu HedgeDoc findest du auch auf unserer Produktseite.