Das Büro-Wiki im Markdown-Ordner — OpenKnowledge macht es editierbar
OpenKnowledge wandelt einen Markdown-Ordner in ein AI-lesbares Büro-Wiki über MCP um — und hält dein Wissen in Dateien, die den Vendor überdauern.
Jede Praxis, die ich kenne, hat eine Wissensbasis, die gleichzeitig drei Orte besetzt: ein SharePoint, dem keiner traut; ein Notion, das keiner mehr zahlt; und den Kopf eines Bauleiters. Die Dateien, die zählen — Detail-Notizen, BEP-Fragmente, das Memo »warum wir die Fassade so gemacht haben« — sind fast immer reiner Text irgendwo. Das Programm zum Editieren wechselt. Der Text nicht.
Das ist das stille Argument hinter OpenKnowledge, diesen Monat bei Hacker News gepostet vom Team bei Inkeep als GNU-GPL-v3.0-oder-später Alternative zu Obsidian und Notion. Es editiert Markdown- und MDX-Dateien in einem Ordner auf deiner Platte mit einer echten WYSIWYG-Oberfläche, die sich wie Google Docs anfühlt, und verbindet AI-Agenten — Claude Code, Claude Desktop, Cursor, Codex, OpenCode, Pi — direkt über MCP mit demselben Ordner. Notion trifft VS Code, wie ihr README sagt — eine faire Beschreibung und auch ein Geständnis, wer die Zielgruppe ist.
←HEUTE: Dein Projektwissen ist Markdown in einem Ordner; der Editor ist gemietet, der Ordner dir.
→3012: Die Archive, die bis Zürich-3012 überdauerten, waren die Plain-Text-Archive — niemand schrieb einen Reader für eine tote Notiz-App.
Fulcrum: Ein AI, das dein Büro-Wissen liest, ist nur sinnvoll, wenn dieses Wissen den Vendor überdauert.
Das Werkzeug:
OpenKnowledge (inkeep/open-knowledge auf GitHub) ist ein local-first Markdown- und MDX-Editor mit Datei-Navigator, Suche, Tabs und Graph-View für Wiki-Links. Es kommt als macOS DMG und für alle anderen — Linux, Windows, Intel Mac — als Node.js 24+ CLI, die denselben Editor als lokale Web-App serviert. Sync und Team-Sharing laufen unter git und GitHub — kein proprietärer Sync-Server, keine Seat-Licence. Das eines Architekten Nachmittag wert ist: die MCP-Layer. ok init installiert Skills und einen agentic search endpoint für jeden Harness, den es auf deiner Maschine findet, damit ein Coding-Agent Dokumente im Vault lesen und verfassen kann, ohne etwas in eine Chat-Box zu pasten. Es rendert auch einbettbares HTML und Rich-Components — das ist das Feature, das Engineering-Specs und visualisierte Reports plausibel statt schmerzhaft macht.
Weil dein Büro den Corpus längst hat. Nur nicht maschinenlesbar.
Setup:
# Node.js 24+ und git erforderlich
npm install -g @inkeep/open-knowledge
# auf echte Inhalte richten, nicht auf einen leeren Ordner
cd ~/projects/office-wiki
git init # skip if already a repo
ok init # scaffolds + verbindet erkannte AI-Editoren (Claude Code, Cursor, Codex...)
ok start --open # serviert den Editor, öffnet deinen Browser
Auf macOS kannst du die CLI ganz auslassen: lade die DMG, zieh sie ins Programmverzeichnis, start. So oder so öffnest du einen bestehenden Ordner — ein altes Obsidian-Vault, ein docs-Verzeichnis im Codebase, den Stapel .md-Dateien, die du aus Notion exportiert hast.
Erste Schritte:
- Öffne einen Ordner, der dir schmerzt. Nicht ein Demo-Vault, sondern dein echtes Verzeichnis mit Standard-Detail-Notizen oder BEP-Entwürfen. Falls sie .docx sind:
pandoc -t gfmdrüber. Der Konversionsverlust ist real aber überlebensfähig, und es ist der Ausweg aus einem Format, das du nicht kontrollierst. - Erstelle zwei Wiki-Links. In irgendeiner Notiz schreibe
[[IFC-Export-Settings]]und[[Fassade-U-Wert-Nachweis]]. Öffne die Graph-View. Du hast jetzt das kleinste mögliche Bild, wie dein Büro-Wissen tatsächlich zusammenhängt — meist ein Schock, meist zwei verwaiste Cluster und ein Hub. - Lass den Agent die MCP-Verdrahtung nutzen, die ok init installiert hat. Dann stell deinem Harness eine Frage, die du normalerweise einem Kollegen stellen würdest: »Welche Projekte nutzten das gleiche Fenster-Detail wie das in 2024-notes/?« Die Antwortqualität sagt dir mehr über deine Notiz-Hygiene aus als über das Modell.
- Commit.
git add -A && git commit -m "wiki: first pass". Sync ist nur git. Das ist alles — und genau die richtige Menge.
Der Teil, wo ich skeptisch werde
Lass mich die Trade-offs klar aussprechen, weil die App-Presse es nicht tun wird. Der XDA-Artikel über Obsidian-Alternativen macht den ehrlichen Punkt: diese Tools ergänzen statt zu ersetzen — und ein Büro zu einem neuen Knowledge-Editor zu migrieren kostet echt in Retraining und halb-migrierten Inhalten. OpenKnowledge ist jung. WYSIWYG-Markdown-Editoren haben eine lange Tradition, Tabellen, Fussnoten und alles mit eingebettetem HTML leise zu zerstören. Test es auf einer Kopie deines Repos, nicht auf dein echtes Repo.
Aber das Risiko ist begrenzt auf eine Art, die zählt — und das ist der Grund, warum ich über eine Notiz-App auf dem BIM-Desk schreibe. Falls OpenKnowledge nächstes Jahr verschwindet, hast du immer noch einen Markdown-Ordner in einem git-Repo. Jeder Editor, der je existiert hat, kann ihn öffnen. Vergleich das mit dem Fehler-Szenario einer gehosteten Block-Workspace: »Export« ist ein ZIP voller HTML, Dateinamen sind generiert, deine Links verrotten.
Warum das ein BIM-Problem ist, nicht ein Büro-Material-Problem
Der How-To-Geek-Roundup von übersehenen Open-Source-Tools rahmt solche Apps als persönliche Produktivitätsfunde. Für ein Büro ist es näher an einer Records-Frage. Unsere Industrie hat dreissig Jahre Belege dafür, was passiert, wenn Projektwissen in einem firmeneigenen Format sitzt: es wird Archäologie. Ich verbringe einen Teil meines Arbeitslebens mit IFC-Roundtrips, genau weil irgendwer irgendwo mal entschieden hat, dass das native Format für immer ausreicht.
Die Gebäude, die gealtert haben, waren nie die hässlichen. Sie waren die, deren Dokumentation keiner öffnen konnte. Falls du einen Knowledge-Stack dieses Quartal wählst, stell eine Frage: Wenn der Vendor dunkelgeht, kann ein 25-Jähriger die Datei noch lesen? Markdown in git: ja. Fast sonst nichts.
Es gibt einen Second-Order-Effekt auch. Ein Plain-Text-git-gestütztes Vault ist der billigste mögliche Untergrund für die agentic search, die alle jetzt als Service kaufen möchten. Du brauchst keinen RAG-Vendor, um dein Büro-Wiki zu indexieren, wenn es schon 400 Text-Dateien mit vernünftigen Namen sind. PAZ’s eigenes »Creative Coding — En Ingenieria«-Panel argumentiert: die expressive Skizze und das Production-Script sind die gleiche Fähigkeit auf zwei Höhen; das Gleiche gilt hier. Das Dateiformat, das du greppen kannst, ist das Dateiformat, das dein Agent verstehen kann.
Atelier: Für ein Büro, das AI dieses Jahr adoptiert, ist die Binding-Constraint nicht Modell-Qualität — sondern dass dein Institutionswissen in PDFs, E-Mails und einem Notion-Workspace sitzt, den eine Person administriert. OpenKnowledge ist eine billige Art zu testen, ob ein git-gestütztes Markdown-Vault plus ein MCP-verbundener Agent wirklich echte Projektfragen beantworten können, bevor du etwas unterschreibst. Montag-Move: Nimm dein einziges am-meisten-referenziertes internes Dokument — die IFC-Export-Checkliste des Büros, den Standard-Detail-Index, was Leute sich gegenseitig screenshoten — konvertiere es zu Markdown, leg es in ein git-Repo, starte ok start. Ein File. Wenn der Agent Fragen zu diesem einen File beantworten kann, hast du deinen Piloten.
Hack: Finde heraus, welche Notizen verwaist sind, bevor du der Graph-View traust. Wiki-Links helfen nur, wenn sie bestehen, und die meisten migrierten Vaults sind 80% unverlinkte Trümmer. Lauf das vom Root deines Markdown-Ordners: es listet jede .md-Datei, die keiner linkt — deine Dead-Ends, nach Peinlichkeit gereiht. Fix die Top-Zehn von Hand, rerun.
import re, pathlib
files = {p.stem: p for p in pathlib.Path(".").rglob("*.md")}
linked = set(re.findall(r"[[([^]|#]+)", "n".join(p.read_text(errors="ignore") for p in files.values())))
for stem in sorted(set(files) - {l.strip() for l in linked}):
print(stem)
Lern-Ressourcen:
- Das Repo: github.com/inkeep/open-knowledge — GPL v3.0-oder-später, Issues und PRs offen.
- Docs: openknowledge.ai/docs — allgemeine Nutzung, Starter-Packs für LLM-Wikis und Second Brains.
- Context zu den Alternativen: XDA — wenn dein Obsidian-Vault zu aufgebläht wird, eine hilfreiche Korrektur zur Migrations-Komplexität.
- Das grössere Muster: How-To Geek — übersehene Open-Source-Apps.
- PAZ-Anmerkung: das gleiche Argument läuft durch unsere IFC- und Format-Langlebigkeits-Coverage — der Punkt von offenen Formaten war nie Ideologie, sondern die Fähigkeit, die Datei 2051 noch zu öffnen.
Also: clone es, richte es auf einen Ordner, der im Büro schon Streit verursacht, und schau, ob der Agent eine Frage beantworten kann, die du leid bist. Lauf es auf einer Kopie, auf deinem hässlichsten Verzeichnis, und lass die Graph-View dir zeigen, was dein Büro wirklich kennt.
QUELLE · ↗
PAZ Kaffi · interdisziplinäre Redaktionsarbeit, geleitet von der PAZ Academy