BookBridge
What is BookBridge?
BookBridge is an Obsidian Community Plugin for bidirectional sync between your Obsidian vault and a BookStack instance.
Features
- HTML to Markdown Conversion — Turndown with custom rules for BookStack-specific elements
- Local Images & Attachments — Every image and PDF is stored locally, full offline access
- Deletion Sync — Detects deleted pages, asks for confirmation
- Conflict Diff — When changes exist on both sides, the user decides, not the machine
- Incremental Sync — Only changed pages via
updated_atcomparison
Tech Stack
| Component | Technology |
|---|---|
| Runtime | Obsidian Plugin API (TypeScript) |
| Build | esbuild |
| Test | Vitest |
| API | BookStack REST API v1 |
| Conversion | Turndown + Custom Rules |
Installation
BookBridge is available as a Community Plugin in Obsidian. Alternatively via GitHub:
git clone https://github.com/rotecodefraktion/bookbridge
cd bookbridge
npm install && npm run build
Origin
Built with Claude Code as co-developer — two specialized agents (plugin-dev and qa-engineer), four workflow skills, and strict TypeScript rules.
More about this in the blog post →
Translated with the help of Claude
