The Problem
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.
The three axes of friction
Section titled “The three axes of friction”Three things need to work simultaneously. Existing tools pick one or two and concede the rest.
Every existing Obsidian-to-web tool sits on an edge, not in the middle. Cyberbaser’s thesis is that with the right translation layer, you can occupy the interior.
The specific pain
Section titled “The specific pain”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:
- 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.
- 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.
- 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.
Who feels the pain
Section titled “Who feels the pain”Primary user — the vault-native practitionerAlready 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 contributorReads 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 developerComfortable 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.
Why existing solutions don’t cover this
Section titled “Why existing solutions don’t cover this”Three constraints fall out of the principles. Each existing solution fails at least one.
| Obsidian fidelity | Low-friction contribution | No 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) | ✅ | ✅ | ✅ |
Scope boundaries
Section titled “Scope boundaries”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.
Success looks like
Section titled “Success looks like”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.