HedgeDoc: Notizen gemeinsam in Markdown schreiben

Mit HedgeDoc (hedgedoc.ethz.ch) schreiben ETH-Angehörige Sitzungsprotokolle, Notizen und Texte gemeinsam in Echtzeit, in Markdown, mit Freigabe per Link, Versionen, Export und Folienmodus.

Was ist HedgeDoc?

HedgeDoc (hedgedoc.ethz.ch) ist der gemeinsame Online-Editor für Notizen und Texte des Departements Architektur der ETH Zürich. Mehrere Personen schreiben gleichzeitig am selben Dokument und sehen die Änderungen der anderen in Echtzeit. Die Texte werden in Markdown geschrieben und daneben sofort formatiert angezeigt. Typische Einsätze: Sitzungsprotokolle, Pendenzenlisten, Konzepte und Entwürfe, Notizen in Vorlesungen und Workshops, Checklisten, Anleitungen oder einfache Präsentationen.

HedgeDoc ist die ETH-interne Alternative zu Etherpad, HackMD, CodiMD oder einem geteilten Google-Doc für Notizen. Es ist Open Source und läuft auf Servern der ETH Zürich; die Inhalte bleiben an der ETH. Notizen erstellen können alle Angehörigen der ETH Zürich mit ihrem ETH-Konto. Wer eine Notiz nur lesen oder mitschreiben soll, braucht je nach Freigabe kein Konto.

Notiz erstellen

Öffnen Sie hedgedoc.ethz.ch und klicken Sie auf Sign In. Melden Sie sich unter Sign in via ETH Zurich (LDAP) mit Ihrem ETH-Benutzernamen (ohne @ethz.ch) und Ihrem ETH-Passwort an. Ein separates Konto brauchen Sie nicht.
Klicken Sie oben rechts auf New note. Die neue Notiz öffnet sich mit einer zufälligen, nicht erratbaren Adresse. Die erste Überschrift (# Titel) wird zum Titel der Notiz.
Schreiben Sie links in Markdown, rechts sehen Sie die formatierte Vorschau. Mit den drei Symbolen oben links wechseln Sie zwischen View (nur Vorschau), Both (geteilt) und Edit (nur Editor). Die Werkzeugleiste über dem Editor fügt Fett, Listen, Tabellen, Links, Bilder und Code ein.
Speichern müssen Sie nichts: Jede Änderung wird sofort gesichert. Alle Ihre Notizen finden Sie später auf der Startseite unter History.

Gemeinsam schreiben und teilen

Zum Teilen genügt die Adresse der Notiz aus der Browserzeile. Wer die Notiz geöffnet hat, erscheint oben rechts im Zähler Online, und jede Person schreibt mit einem eigenen farbigen Cursor. Wer lesen und wer schreiben darf, legen Sie als Besitzerin oder Besitzer über das Schloss-Symbol rechts oben in der Vorschau fest:

Freigabe	Lesen	Bearbeiten
Freely	alle mit Link	alle mit Link, auch ohne Konto
Editable	alle mit Link	angemeldete ETH-Angehörige
Limited	angemeldete ETH-Angehörige	angemeldete ETH-Angehörige
Locked	alle mit Link	nur Besitzer/in
Protected	angemeldete ETH-Angehörige	nur Besitzer/in
Private	nur Besitzer/in	nur Besitzer/in

Publish: Erzeugt eine aufgeräumte Leseansicht ohne Editor, etwa um ein fertiges Protokoll zu verteilen.
Menu → Revision: Zeigt frühere Fassungen der Notiz; eine ältere Version lässt sich mit Revert wiederherstellen.
Kommentare im Text: Für Rückfragen im Dokument eignen sich Markierungen wie ==Hervorhebung== oder ein Hinweisblock :::info.

Markdown in Kürze

Markdown ist eine einfache Textauszeichnung: Sie schreiben Zeichen wie # oder *, HedgeDoc macht daraus Überschriften und Formatierungen. Die wichtigsten Elemente:

Sie schreiben	Sie erhalten
`# Überschrift`, `## Unterüberschrift`	Überschriften (Ebene 1, 2, …)
`fett`, `kursiv`, `~~durchgestrichen~~`	Textauszeichnung
`- Punkt` oder `1. Punkt`	Aufzählung oder nummerierte Liste
`- [ ] offen`, `- [x] erledigt`	Checkliste mit anklickbaren Kästchen
`[Text](https://ethz.ch)`	Link
`![Bildtext](bild.png)` oder Bild in den Editor ziehen	Bild; eingefügte Bilder werden hochgeladen
`\| A \| B \|` mit Trennzeile `\|---\|---\|`	Tabelle (die Werkzeugleiste fügt eine Vorlage ein)
``` … ```	Codeblock mit Syntaxhervorhebung
$E = mc^2$	Mathematische Formel (LaTeX/MathJax)
```mermaid … ```	Diagramm (Flussdiagramm, Sequenz, Gantt) mit Mermaid
`:::info` … `:::` (auch `success`, `warning`, `danger`)	Farbiger Hinweiskasten
`[TOC]`	Inhaltsverzeichnis aus den Überschriften
`{%youtube VIDEO_ID %}`	Eingebettetes Video
`:smile:`	Emoji

Eine vollständige Übersicht öffnet das Fragezeichen-Symbol im Editor (Cheatsheet), die Beispielnotiz Features zeigt alle Möglichkeiten.

Präsentation aus einer Notiz

HedgeDoc macht aus einer Notiz eine Folienpräsentation: Trennen Sie die Folien mit einer Zeile --- und wählen Sie Menu → Slide Mode. Die Folien laufen im Browser, mit den Pfeiltasten blättern Sie, F schaltet auf Vollbild. So entsteht ohne PowerPoint eine Präsentation, die Sie bis zur letzten Minute gemeinsam überarbeiten können.

Export und Sicherung

Menu → Download: Eine Notiz als Markdown oder HTML speichern, zum Beispiel für die Ablage im Projektordner oder zum Weiterverarbeiten in Word.
Startseite → Export user data: Alle eigenen Notizen auf einmal als ZIP herunterladen.
Import: Bestehenden Markdown-Text über Menu → Import aus der Zwischenablage einfügen.

Gut zu wissen

Für alle Geräte: HedgeDoc läuft im Browser auf Desktop, Tablet und Smartphone, ohne Installation.
Datenschutz: HedgeDoc läuft auf Infrastruktur der ETH Zürich und wird von der IT-Gruppe des Departements Architektur betrieben. Es werden keine Daten an Dritte weitergegeben.
Handbuch: Die ausführliche Dokumentation finden Sie unter docs.hedgedoc.org.

Bei Fragen wenden Sie sich an den Service Desk.

Nicht gelöst? Anmelden, um ein Ticket zu eröffnen, oder direkt an den D-ARCH Service Desk, servicedesk@arch.ethz.ch