Importing Bookmarks¶
Knowmarks can import your existing bookmarks from multiple sources. Bulk imports (10+ items) use a phased pipeline — items appear in search immediately with basic metadata, then content extraction and embedding happen in the background.
Browser Bookmarks¶
Chrome¶
km import chrome
Imports from Chrome's default bookmark file. All bookmark folders are preserved as metadata.
Safari (macOS)¶
km import safari
Reads from Safari's bookmark plist. Requires macOS.
Firefox¶
km import firefox
Imports from Firefox's places database.
Bookmark Files¶
Import an exported bookmarks HTML file from any browser:
km import file bookmarks.html
Supports standard Netscape bookmark format (the HTML format used by all major browsers for bookmark export).
Tip
If some bookmarks fail to parse, Knowmarks reports the errors and continues importing the rest. Check km status after import to see how many succeeded.
GitHub Stars¶
km import github <username>
Imports your starred repositories. Each star becomes a knowmark with the repository description, language, and star count as metadata.
Readwise Reader¶
km import readwise --token YOUR_TOKEN
Imports documents from your Readwise Reader library. Get your API token from readwise.io/access_token.
Karakeep¶
Karakeep import is configured through the dashboard:
- Open the dashboard (
km serve) - Go to Settings
- Enter your Karakeep server URL and API token
- Click Connect
Once connected, Karakeep appears as a connector with configurable polling intervals.
After Importing¶
After a bulk import:
- Items are searchable immediately by title, URL, and domain
- Content extraction runs in the background (you'll see "enriching" status in Pulse)
- Clusters rebuild automatically once enough embeddings are ready
- Check Pulse for any items that need attention (failed fetches, near-duplicates)
You can continue using Knowmarks normally while enrichment runs.