Skip to content
🧠 Research & Foundations phase — building the KB from the ground up. See the roadmap →

The Problem

Updated

An Obsidian vault is a great private knowledge base. Turning it into a contributable public wiki — without losing Obsidian’s affordances or locking contributors into git — is a problem nobody has fully solved. Cyberbaser is the attempt.

Three things need to work simultaneously. Existing tools pick one or two and concede the rest.

A cyber practitioner wants to publish knowledge — both for themselves and for others to find, reference, and correct. They already use Obsidian (or something like it) as their personal authoring surface. They reach for a publisher and find three kinds of tools:

  1. Obsidian-aware publishers (Obsidian Publish, Quartz, Digital Garden). Great fidelity — wikilinks work, callouts render, embeds show up. But contribution is an afterthought. Readers can’t edit. At best, you get a GitHub “Edit” link that drops them into a raw markdown editor with no Obsidian syntax support.
  2. Git-backed CMSes (Decap, Sveltia, Tina). Great contribution story — Open Authoring lets anonymous readers submit PRs. But they don’t understand Obsidian syntax. Wikilinks flatten to plain text. Callouts become quoted lines. The vault-side user and the CMS user are writing different dialects.
  3. Docs platforms repurposed as wikis (Docusaurus, Mintlify, GitBook). Beautiful reader UX, polished contribution flows. But opinionated content schemas; forcing Obsidian content into their shape is lossy and maintenance-heavy.

None of these occupy the interior of the triangle. Cyberbaser’s hypothesis is that the gap is a translation-layer problem, not a new-SSG problem — if you can guarantee round-trip fidelity between Obsidian syntax and a web-edit surface, you can compose an Obsidian-aware publisher with a git-backed CMS and get all three properties.

Primary user — the vault-native practitioner
Already uses Obsidian. Has a personal cyber knowledge base they’d like to share. Values the wiki feel (crosslinks, discovery). Will not move to Notion or Publish because of vendor lock-in. Will not hand-maintain a separate publishing stack because it’s too much work.
Secondary user — the domain-expert contributor
Reads the published wiki, spots a gap or error. Knows the topic cold. Does not know git. Has a GitHub account because they needed one for something else. Would contribute if it took three clicks; will not contribute if it takes a terminal.
Tertiary user — the git-native developer
Comfortable with git but has never used Obsidian. Treats the vault repo like any other docs repo — edit a .md file, open a PR. Shouldn’t be forced to understand Obsidian syntax to contribute a typo fix.

Three constraints fall out of the principles. Each existing solution fails at least one.

Obsidian fidelityLow-friction contributionNo vendor lock-in
Obsidian Publish⚠️ (read-only for visitors)❌ (proprietary hosting)
Quartz v4❌ (git required)
Digital Garden❌ (git required)
Docusaurus / GitBook / Mintlify❌ (lossy for Obsidian)⚠️ (platform-specific)
awesome-list repos❌ (plain markdown only)
Notion-as-wiki❌ (no Obsidian import fidelity)
cyberbaser (target)

Equally important — what cyberbaser is not trying to solve, so future-me doesn’t scope-creep.

  • Not a general-purpose Obsidian publisher. It’s built for the cyberbase vault’s content shape first. Generalization is a stretch goal, not a design goal.
  • Not a replacement for Obsidian Publish. It’s a parallel option with different trade-offs.
  • Not a vault host. The vault lives in cybersader/cyberbase. Cyberbaser reads from it.
  • Not a comments / discussion system. GitHub Issues is the fallback.
  • Not a realtime-collaborative editor. Conflicts resolve via git, not CRDT.

Cyberbaser is successful when:

  • A reader lands on a wiki page from a Google search and doesn’t notice that it came from an Obsidian vault — it just reads as a well-maintained wiki.
  • That same reader can submit a typo fix in three clicks, without learning git, and see it live within minutes.
  • The maintainer reviews and merges the edit without leaving Obsidian as their primary authoring surface.
  • The vault repo remains fully usable in Obsidian standalone — nothing cyberbaser-specific leaks into it.
  • Ten independent contributors, with different git fluencies, produce identical-quality edits to the same set of pages.