Documentation
Bookmarks But Better turns your new tab into a private bookmarks dashboard, with no account and no tracking. These docs cover the browser extension and the optional daemon that keeps your bookmarks as plain Markdown files in a vault you own.
Getting started
Section titled “Getting started”Install the extensionAdd it to Chrome or Firefox. Safari is coming soon.
SourcesBrowser bookmarks, Markdown vaults and the active source.
Import and exportHTML from any browser, CSV from Raindrop and Pocket, HTML export.
SafariComing soon. Build it from source to use it with a Markdown vault now.
Markdown vaults
Section titled “Markdown vaults”What is a Markdown vault?Bookmarks as plain files you own, served by a local daemon.
Install the daemonSet up the local daemon with npx or an install script.
Connect the extensionPoint the extension at the daemon on 127.0.0.1.
Multiple vaultsHost several vaults in one daemon, each its own source.
Back up your vaultWhat to copy, which tools work, and how to restore.
TroubleshootingFix a daemon that does not start or connect.
UninstallRemove the daemon and its service; your vault stays put.
Guides
Section titled “Guides”Pocket alternativeImport your Pocket CSV. What carries over and what doesn't.
Raindrop alternativeHow a cloud account and local bookmarks compare.
Obsidian bookmarksKeep bookmarks as Markdown next to your Obsidian notes.
Without an accountWhat local means in practice, and the trade-offs.