Doku-Tool: Obsidian + GitHub vs. Alternativen
TL;DR: Privates GitHub-Repo wird zum gemeinsamen Vault. Sync läuft über das
obsidian-git-Plugin (Auto-Pull/Commit/Push). Auth & Rechte = GitHub-Team-Permissions (kein extra User-Management, 0 €). Optional: GitHub Action publiziert den Vault als statische, durchsuchbare Website (Quartz) auf GitHub Pages.
Warum dieser Ansatz?
| Anforderung | Lösung |
|---|---|
| Bestehende GitHub-Accounts nutzen | Repo im eBusEmmos-Org → Team-Permissions greifen automatisch |
| Keine Extra-Kosten | GitHub kostet nichts zusätzlich |
| Gemeinsamer, aufgeräumter Vault | Repo-Struktur + PR-Reviews bei größeren Umbauten |
| Obsidian-Plugins (Excalidraw, Slides, Dataview, Canvas) | Obsidian bleibt 1:1 erhalten |
| KI-Fütterung | Markdown im Repo → trivial für Copilot/Claude/Cursor |
| Versionierung & History | Git-nativ, besser als Obsidian Sync |
Trade-off: Kein Echtzeit-Co-Editing wie Google Docs. Bei gleichzeitigem Editieren derselben Datei → Merge-Konflikt. In der Praxis bei Doku selten kritisch.
Alternativen-Vergleich
| Aspekt | Obsidian + Git | Obsidian Sync | Notion | Confluence | Outline | HedgeDoc |
|---|---|---|---|---|---|---|
| Echtzeit-Co-Editing | ❌ | ⚠️ | ✅ | ✅ | ✅ | ✅ |
| GitHub-Auth/SSO | ✅ nativ | ❌ | ⚠️ Enterprise | ⚠️ Enterprise | ✅ | ⚠️ |
| Obsidian-Plugins | ✅ alle | ✅ alle | ❌ | ❌ | ❌ | ❌ |
| Lokal-first / Offline | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| Markdown-nativ | ✅ | ✅ | ⚠️ Export | ⚠️ Export | ✅ | ✅ |
| Versionierung | ✅ Git | ⚠️ | ⚠️ | ✅ | ⚠️ | ⚠️ |
| Kosten | 0 € | 4–10 $/User/Mo | 8–20 $/User/Mo | 6–11 $/User/Mo | Self-host | Self-host |