§ Gids · Obsidian voor teams
Obsidian maakt van losse notities een doorzoekbaar tweede brein — en een ideale kennisbron voor AI Agents.
Obsidian is een lokaal-eerst markdown-platform met bidirectionele links, plugins en een graph view. Voor teams die kennis willen bewaren zonder vendor lock-in én die kennis willen ontsluiten voor AI Agents, is het een natuurlijke fundering. Hieronder: wat het is, wanneer je het kiest, en hoe wij het productieklaar maken.
01 — Definitie
Wat is Obsidian?
Obsidian is een lokaal-eerst notitie- en kennisbankplatform dat draait op gewone markdown-bestanden in een map (de 'vault') op je eigen schijf. Geen database, geen cloud-verplichting, geen propriëtair format — je bestanden blijven leesbaar in elke teksteditor.
Wat Obsidian onderscheidt is de combinatie van bidirectionele links ([[wikilinks]]), backlinks, een visuele graph view en een diepgaand plugin-ecosysteem. Dat maakt het geschikt voor persoonlijke kennisbeheer én voor teams die een doorzoekbare, versiebeheerde kennisbron willen bouwen die ook door AI Agents te lezen is.
02 — Architectuur
Kernconcepten op één pagina
Vault
Een map met markdown-bestanden, attachments en config. Een vault leeft op je schijf, syncbaar via git, Obsidian Sync, iCloud, Dropbox of je eigen S3.
Wikilinks & backlinks
Met `[[Concept]]` link je naar een ander notitie-bestand. Elke notitie ziet automatisch wie naar haar verwijst — de bouwstenen van een netwerkstructuur in plaats van een mappenstructuur.
Graph view
Visualisatie van alle notities en hun verbindingen. Handig om witte vlekken in een domein te zien en om verbindingen te ontdekken die je niet had verwacht.
Plugins (core + community)
Dataview voor queries over je vault, Templater voor templates, Excalidraw voor diagrammen, Smart Connections en Copilot voor lokale AI op je eigen notities.
Properties / frontmatter
YAML aan de top van elke notitie maakt notities queryable: tags, status, datum, eigenaar. Dat is wat een vault van 'rommel' naar 'database' tilt.
Obsidian versus de alternatieven
| Dimensie | Obsidian | Notion | Roam Research |
|---|---|---|---|
| Data-eigendom | Lokale markdown-bestanden | Cloud (Notion-database) | Cloud (proprietary) |
| Offline werken | Volledig offline | Beperkt | Beperkt |
| Linking | Bidirectioneel + graph | Mentions, beperkt graph | Bidirectioneel + outliner |
| Doelgroep | Engineers, schrijvers, onderzoekers | Teams, projectmanagement | Onderzoekers, denkers |
| Uitbreidbaarheid | 1000+ community plugins | API + Notion AI | Beperkt plugin-systeem |
| AI-integratie | Lokaal via plugins of API | Notion AI ingebakken | Beperkt |
| Data-residency | Volledig in eigen beheer | VS-gebonden | VS-gebonden |
03 — Toepassing
Wanneer kies je Obsidian (en wanneer niet)?
Wel Obsidian
- Persoonlijk of team-kennisbeheer met focus op langetermijn-eigendom van data.
- Onderzoek, documentatie en interne wiki's waarbij markdown en git natuurlijke formats zijn.
- Kennisbron als input voor AI Agents (RAG) zonder data naar een SaaS te sturen.
- Gevoelige of gereguleerde domeinen waar cloud-only tools niet mogen.
Geen Obsidian
- Realtime collaboration met meerdere mensen tegelijk in dezelfde notitie — pak Notion of Google Docs.
- Projectmanagement met taken, deadlines en views — Linear, Notion of Asana zijn natuurlijker.
- Niet-technische teams die geen markdown willen leren en zonder onboarding moeten kunnen starten.
04 — Operatie
Productie, governance en AI-koppeling
Vault-structuur en conventies
Een vault zonder structuur wordt binnen een half jaar onbruikbaar. Wij ontwerpen folder-conventies, naming, verplichte frontmatter-velden en een MOC-systeem (Map of Content) per domein.
Versiebeheer via git
Vaults in git geeft history, branches en review. Voor teams zetten we een private repo op met pre-commit hooks die frontmatter en links valideren.
RAG voor AI Agents
We exposen de vault als kennisbron voor AI Agents: chunking op koppen, embeddings in Postgres + pgvector, hybrid search (BM25 + vector) en citaties terug naar het bron-bestand.
On-prem AI via OpenClaw
Voor regulated klanten draaien we Obsidian-vault + lokale inference via OpenClaw. Notities en prompts verlaten het netwerk niet, en agents citeren altijd terug naar de oorspronkelijke notitie.
05 — Risico
Valkuilen die we in pilots tegenkomen
Plugin-explosie
Tien actieve plugins maken je vault traag en breekbaar bij elke Obsidian-update. Beperk tot een goedgekeurde, gepinde set en update bewust per kwartaal.
Geen frontmatter-discipline
Zonder verplichte properties (type, status, eigenaar) is je vault niet queryable. Dataview en RAG-pipelines worden dan ruis in plaats van signaal.
Sync-conflicten
Drie sync-tools tegelijk (iCloud + Obsidian Sync + git) is een recept voor stille dataverlies. Kies één sync-pad en documenteer het.
Vault wordt persoonlijk dagboek
Zonder duidelijke scope groeit een team-vault uit tot een mix van strategie, scratchpad en meeting-notes. Splits per doel en bewaak de grenzen.
Onze positie: Obsidian is een uitstekende kennisbron voor agents — mits gestructureerd
Een Obsidian-vault is voor ons regelmatig de beste bron voor RAG: markdown is leesbaar, links geven semantische context, en data blijft in eigen beheer. Maar een vault zonder conventies levert een agent geen waarde — het levert hallucinaties.
Het verschil tussen een leuke persoonlijke vault en een productieklare kennisbron zit altijd in dezelfde dingen: structuur, frontmatter, versiebeheer, retrieval-architectuur en citaties. Dát is Agentic Engineering.
Obsidian als kennisfundament voor AI Agents?
We helpen teams Obsidian-vaults inrichten en koppelen aan AI Agents: structuur, conventies, git-workflow, RAG-pipeline en — indien gewenst — een on-prem variant via OpenClaw.
Veelgestelde vragen
Is Obsidian gratis?
+
Voor persoonlijk gebruik is Obsidian gratis. Voor commercieel gebruik is er een betaalde licentie per gebruiker. Obsidian Sync en Publish zijn aparte betaalde diensten.
Kan ik mijn Notion-content migreren naar Obsidian?
+
Ja. Notion exporteert naar markdown; met een paar transformaties (link-rewriting, frontmatter toevoegen) krijg je een werkende vault. Wij doen dit regelmatig als onderdeel van een data-soevereiniteitstraject.
Hoe koppel ik Obsidian aan een AI Agent?
+
We indexeren de vault (chunking + embeddings) in een vector store, en geven de agent een retrieve-tool met citaties terug naar het bron-bestand. Alles lokaal of in jouw cloud, geen vault-content naar een SaaS.
Wat is het verschil tussen Obsidian en een wiki?
+
Een klassieke wiki is een centrale webapp met een database. Obsidian is een lokale map met markdown-bestanden en links — meer als een persoonlijk netwerk dat je kunt versionen, syncen en doorzoeken zonder server.