Markbase vs. Obsidian

Keep Obsidian. Add Markbase.

Obsidian is a beautiful tool for humans editing notes on one machine. Markbase is the same data shape — plain markdown in folders — built for the moment your agents need to share that memory over the network.

What each tool is great at

Obsidian is local-first, low-code, and built around a personal editing experience. Backlinks, graph view, canvas, plugins, daily notes. It's one of the best tools ever made for a human thinking on a single machine.

Markbase is none of those things. It has no UI, no plugins, no graph view. It's a hosted MCP endpoint that exposes your markdown to agents over HTTPS, with concurrency control so several agents can write to it at once without trampling each other.

They solve different problems. You can — and probably should — use both.

Where Obsidian stops being enough

Obsidian was never built to be an API. The moment you want this:

  • A second agent on a remote machine reading the same notes
  • Claude Code on your laptop and Claude.ai on your phone seeing the same memory
  • Two parallel agents updating notes without clobbering each other
  • A secure, network-reachable endpoint with OAuth, not a sync hack

…you're outside what Obsidian was designed for. There are community plugins that gesture at this, but exposing a local app as a secure, multi-tenant, public MCP server is not a small project. It's a different product.

Conventions that travel with the memory

An Obsidian vault is a personal space. The conventions for how it's organized live in your head — folder names you settled on, templates you reuse, the daily-note layout you like. When the only reader is you, that's the right amount of structure.

Once a fleet of agents are reading and writing the same memory, "conventions in your head" doesn't scale. Markbase ships _markbase.md as a per-folder governance file. Drop one at any folder root and you've defined the contract for that subtree: what it's for, how docs in it are organized, what frontmatter they need. Agents working on a path read the chain root-to-leaf before acting. You write the rules once, in the store; every agent that touches the subtree applies them.

Typed records, not just notes

Obsidian power users reach for Dataview-style plugins when notes start having shape — frontmatter properties, queries that pretend the vault is a database. It works, but the contract is whatever you remember to type, interpreted by a local plugin that any agent in another harness doesn't see.

Markbase ships the same idea natively. Drop a _schema.md in a folder and that folder is a typed collection: every record conforms to a shape you authored, and agents query the collection by field. The structure lives with the data, not with one app.

Knowledge that isn't stuck in one vault

An Obsidian vault is, by design, a single place you open. The notes you wrote in last year's vault aren't on hand when you're thinking inside this year's. The lessons stay with the vault that holds them.

Markbase keeps each project's memory in its own workspace, but knowledge doesn't have to stay there. An agent working in one project can read design notes, decisions, and postmortems from another in the same conversation, and apply them to what it's building now. Past work is a resource, not a silo.

Can I use both?

Yes — they're different jobs on the same kind of data. The notes are plain markdown either way, so the clean split is: keep Obsidian for the personal thinking you edit by hand, and let your agents read and write the shared memory in Markbase. Same shape, no format conversion.

Side by side

Same format, different jobs.

Feature Obsidian Markbase
Primary user Humans Agents
Interface Desktop / mobile app MCP over HTTPS
Storage Local filesystem Object storage, versioned
Format Markdown Markdown
Network access Sync add-on, plugins Native, public endpoint
Auth for agents None native OAuth 2.1 Resource Server
Concurrency Last write wins ETag idempotency — no silent clobbers
Conventions for agents In your head, or a personal README _markbase.md chain inside the vault
Typed records Plugins (Dataview-style), interpreted locally _schema.md per folder — typed records, queryable by field, server-enforced
Cross-vault knowledge Stuck in whichever vault is open Reusable across your projects in the same conversation
Version history Sync history (paid) Every write is a new version
Plugins, graph, canvas Yes No
Best for Personal thinking Shared agent memory
Plain .md files on both sides — no format conversion, no lock-in. Your notes are still yours, still markdown, still portable.

Invitation-only, for now

Bring your agents a memory layer.

We're working closely with a small group of early teams to make sure Markbase is exactly the memory layer multi-agent systems deserve. If your notes live in Obsidian and your agents need to share them, request an invite and we'll be in touch.