Articles · Developers
Developer notes: replacing Notion with Kition
API docs, snippets, debug logs, ADRs — these notes belong in Markdown + Git, not block JSON.
Kition Team·May 25, 2026·1 min read
Why Kition fits developers better
- Markdown is already the technical lingua franca
- Git sync = a tool you already know
- Agent can read your code repo directly
- Terminal and CLI integration feel native
Suggested vault layout
- tech/<project>/ — per-project notes
- snippets/ — reusable code blocks
- adr/ — architecture decision records
- incidents/ — post-mortems
Related reading
Getting started
Workspace anatomy: vault, docs, tables, agent
A simple mental model: vault = house, documents and tables = rooms, agent = the housemate who actually does chores.
Developers
Managing tech docs + code snippets
A snippets table + a palette entry — "I wrote that snippet before" becomes a 2-second lookup.
