Obsidian: A Local-First Second Brain You Actually Own
Obsidian rebuilds Luhmann's Zettelkasten as plain Markdown files you own. A hands-on PAZ tutorial: clone, link, git-version your studio's knowledge graph.
Long before “second brain” became a productivity slogan, the German sociologist Niklas Luhmann was already running one on paper. His Zettelkasten — the slip-box now archived and digitised at Bielefeld University — held roughly 90,000 index cards, each hand-addressed and cross-referenced, and is widely credited with the machinery behind more than 70 books and nearly 400 articles. The lesson network scientists later formalised is simple: knowledge is not a list, it is a graph. Value lives in the edges, not the nodes.
That is the frontier idea a small Markdown app quietly ships to your desk. Obsidian — built by Shida Li and Erica Xu and released in 2020 — is Luhmann’s slip-box rebuilt as plain text files, plus a force-directed graph that draws the edges for you. Its own landing page is disarmingly literary about the pitch: it opens with Stephen King’s telepathy passage from On Writing — a white rabbit in a cage, the numeral 8 inked on its back in blue — to argue that a note is really a transmission across time and space between a sending desk and a receiving mind. It then demos linking with René Descartes’ Meditations on First Philosophy (1641), walking from a priori reasoning through a posteriori empiricism to cogito, ergo sum. The product is teaching epistemology to sell you a note-taking app. Cute — and, for once, honest, because the whole point is that structured doubt needs somewhere to accrete.
The mechanism that makes this possible now, and not in 2005, is Markdown. John Gruber’s lightweight syntax (2004, later formalised as CommonMark) means an Obsidian vault is nothing but a folder of .md files on your own disk — no proprietary database, no mandatory cloud. As It’s FOSS notes in its Obsidian-versus-Logseq comparison, both tools lean on this same plain-text substrate; the difference is mostly interface philosophy, not lock-in. (Ignore the search-result noise about “Obsidian” layoffs — that is Obsidian Entertainment, the RPG studio behind Fallout: New Vegas, which PC Gamer reported lost roughly a quarter of its staff to Microsoft’s 2025 Xbox cuts. Pure name collision.)
The Tool: Obsidian is a local-first knowledge base that stores every note as a plain Markdown file, links them with [[wikilinks]], and renders the whole thing as an interactive graph. It is free for personal use and extended by thousands of community plugins and themes. For an architect or computational designer, it is worth an afternoon because it is the rare knowledge tool that does not eat your data — the vault is portable, diff-able, and yours.
Setup:
# Obsidian reads a plain folder — so make the folder a git repo first
mkdir paz-vault && cd paz-vault
git init
printf '# Cogito\n\nDoubt requires thinking — see [[Descartes]].\n' > cogito.md
printf '# Descartes\n\nMeditations on First Philosophy (1641).\n' > Descartes.md
git add cogito.md Descartes.md && git commit -m "first two notes"
# Download Obsidian, choose "Open folder as vault", point it at paz-vault/
First steps:
- Open
cogito.mdin Obsidian and click the[[Descartes]]link — it jumps straight to the second note. That edge is now real. - Press Ctrl/Cmd+G to open Graph View. Two dots, one line. Add a third note that links to both and watch the triangle close.
- Open Settings → Community plugins, install Obsidian Git, and set it to auto-commit every 10 minutes. Your thinking is now version-controlled prose.
←TODAY: In 2026 an Obsidian vault is a folder of Markdown files you can back up, grep, and git-diff without asking a vendor’s permission. →3012: The offices whose knowledge survives are the ones that kept it in open formats they owned, not in someone else’s discontinued cloud. Fulcrum: A tool earns trust not by what it lets you do today but by whether you can walk away with everything when it dies.
Atelier: A Swiss studio’s real knowledge — the BEP boilerplate, the LOIN definitions per project phase, the hard-won detail of who to call at which cantonal Bauamt — usually rots in one senior architect’s inbox. A shared Obsidian vault under git turns that tacit graph into a searchable one the whole Büro can query, and the plain-text base means it outlives any subscription. Your Monday move: create one office vault, put it under version control, and — before you sync it anywhere — read the data-residency clause of whatever backup service you pick. If it does not say where the files physically live, do not use it.
Hack: Pull every [[wikilink]] out of your vault and print the raw edge list of your own thinking — the same graph Obsidian draws, but as data you can feed anywhere.
import re, pathlib
for p in pathlib.Path('.').rglob('*.md'):
for dst in re.findall(r'\[\[([^\]|#]+)', p.read_text(encoding='utf-8')):
print(f'{p.stem}\t{dst.strip()}')
Pipe that into sort | uniq -c | sort -rn and the most-linked note floats to the top — that is your vault’s load-bearing idea, found by counting edges instead of guessing.
Learn-it:
- The tool: obsidian.md — download, docs, and the Descartes demo vault.
- Compare / decide: It’s FOSS — Obsidian vs Logseq, workflow compared.
- PAZ note: treat the office vault the way we treat a Grasshopper definition — version it, review its edges, and never let one person hold the only copy of the graph.
Descartes doubted his way to a single certainty. Kahneman, in Thinking, Fast and Slow — a title that ships inside Obsidian’s own demo vault — showed how easily the fast mind skips the slow reasoning that certainty needs. A vault is where you make System 2 leave a trail. Start one today, link two notes, and commit — the graph is only worth what you actually connect.
SOURCE · ↗
PAZ Kaffi · multidisciplinary editorial, led by PAZ Academy