specgit guides
Collaborate on Obsidian-flavored Markdown in GitHub — with real review
Your vault already lives in a Git repository (or could). specgit is the collaboration layer on top: teammates edit the same notes in a visual editor in the browser, comments become pull request threads, and publishing is a merge — while your Obsidian syntax survives untouched.
Sync is not collaboration
Obsidian Sync moves files between your devices, and the community Git plugin commits your vault to a repo — both solve replication, not teamwork. There's no way for a teammate to propose a change for review, no comment threads on a paragraph, and no approval before an edit lands. The moment a second person touches the vault, you need review — and review is what Git and GitHub were built for.
Wiki links, callouts, and embeds preserved
specgit's editor understands Obsidian-flavored Markdown: wiki links ([[Page]] and aliases), embeds (![[file]]), callouts of any kind with custom titles and fold markers, ==highlights==, footnotes, LaTeX math rendered with KaTeX, YAML frontmatter, task lists, and Mermaid diagrams rendered inline. Syntax the editor doesn't model is preserved byte-for-byte on save, so files opened later in Obsidian look exactly as you left them.
Comments are pull request threads
Highlight a passage and comment — the discussion is a real GitHub pull request review thread, attributed to each person's own GitHub account. Teammates reply from specgit or from GitHub, and the conversation stays attached to the exact change it's about instead of scattering across chat.
Publish by merge
Drafts are branches; publishing merges them. Branch protection and required reviews work end to end — specgit shows what's blocking a publish, reviewers approve in specgit or on GitHub, and "Publish when approved" merges automatically the moment approval lands. If the base branch moved while you wrote, specgit warns early and offers in-editor conflict resolution.
Your vault stays yours
Notes stay plain Markdown files in your GitHub repository — readable by Obsidian and every other tool. specgit reads files when you open them and writes edits back as commits, keeping no long-term copy, with no product analytics or tracking scripts. Access goes through the specgit GitHub App with fine-grained, repo-by-repo permissions; details are on the security and data privacy page.
Give your vault a review workflow
Point specgit at the repo behind your vault. Teammates edit in the browser, you keep writing in Obsidian, and every change goes through real review.
Free to start, no credit card. Your docs never leave GitHub.
By continuing, you agree to the Terms of Use and Privacy Policy.
Frequently asked questions
Does specgit replace Obsidian?
No. Keep writing in Obsidian — specgit is the team collaboration layer on the repo that backs your vault. Teammates who don't use Obsidian edit the same notes in specgit's visual editor in the browser, and changes flow both ways through Git.
Will specgit mangle my Obsidian syntax?
No. The editor understands wiki links ([[Page]] and aliases), embeds (![[file]]), callouts of any kind (custom titles, fold markers), ==highlights==, footnotes, LaTeX math, YAML frontmatter, task lists, and Mermaid diagrams. Anything it doesn't model is preserved byte-for-byte on save — your files stay clean in Obsidian.
How is this different from Obsidian Sync or the Git plugin?
Sync replicates files between your own devices — it has no shared review, comments, or approvals. The community Git plugin commits your vault, but every collaborator needs Git set up and conflicts are theirs to resolve. specgit works on the repo itself: teammates edit in the browser, comments are pull request threads, and merge conflicts get an in-editor resolution flow.
Where do my notes live?
In your GitHub repository, as plain Markdown. specgit reads files when you open them and writes edits back as commits — it keeps no long-term copy, runs no analytics, and uses no tracking scripts. Uninstall anytime; your vault is already yours.
What does it cost?
Free to start: unlimited collaborators on 1 repository with 5 publishes per month, no credit card. Sign in with GitHub through the specgit GitHub App, granting only the repositories you choose.