Linkding Bookmarks Plugin for Obsidian

Display bookmarks from your Linkding collection directly in Obsidian notes.

This plugin allows you to seamlessly integrate your Linkding bookmarks into your Obsidian workflow. Query bookmarks by tags, search terms, or both, and display them as formatted lists within your notes. Perfect for research notes, reference collections, and organizing related resources alongside your thoughts.

Key Features:

• Auto-Search: Empty code blocks automatically find relevant bookmarks using your note's frontmatter tags and title
• Powerful Search: Full support for Linkding's search syntax with boolean operators (AND, OR, NOT), grouping, and phrases
• Flexible Querying: Search by tags (#javascript), text ("hooks tutorial"), or combine both
• Smart Ranking: Auto-search results are ranked by relevance (tag matches first, then title word matches)
• Callout Display: Optionally wrap results in a collapsible Obsidian callout with customizable type
• Smart Rendering: Bookmarks display with titles, descriptions (truncated to configurable length), and tags
• Live Integration: Fetches fresh bookmark data from your Linkding instance
• Clean Formatting: Manual searches are sorted alphabetically; auto-searches preserve relevance ranking
• Easy Setup: Simple API key configuration with connection testing

Installation

Via BRAT (Recommended)

1. Install BRAT plugin
2. Add cloonix/obsidian-linkding as a beta plugin
3. Enable "Linkding Bookmarks" in Community Plugins

Manual Installation

1. Download main.js, manifest.json, and styles.css from the latest release
2. Create folder VaultFolder/.obsidian/plugins/linkding-bookmarks/
3. Place the files in this folder
4. Enable "Linkding Bookmarks" in Community Plugins

Setup

1. Go to Settings → Linkding Bookmarks
2. Enter your Linkding API URL and API key
3. Test connection

Usage

Use Linkding's powerful search syntax in code blocks. The plugin supports the full Linkding search expression syntax including boolean operators and grouping.

Auto-Search (Empty Block)

The simplest way to use the plugin is with an empty code block. It automatically searches for bookmarks relevant to your note based on:

• Frontmatter tags: Matches bookmarks tagged with any of your note's tags
• Note title: Filters results to include at least one word from your note's title

Results are ranked by relevance: bookmarks matching more frontmatter tags appear first.

Example note:

---
tags: [javascript, react]
---
# React Hooks Tutorial

```linkding

This will find bookmarks tagged with `javascript` OR `react` that also contain words like "react", "hooks", or "tutorial" in their title, description, or URL. Bookmarks with both tags will appear at the top.

### Manual Search

For more control, specify your own search query inside the code block.

**Single tag:**
```linkding
#javascript

Multiple tags (implicit AND):

#javascript #react

Search terms:

hooks tutorial

Combined tags and search:

#javascript hooks tutorial

Boolean Operators

AND operator (explicit):

#javascript and #react

OR operator:

#javascript or #python

NOT operator:

#programming not #javascript

Complex queries with grouping:

#tutorial and (#javascript or #python)

Phrases (exact match):

"react hooks" #tutorial

Search Rules

For manual searches:

• Case-insensitive: All searches, tags, and operators are case-insensitive
• Implicit AND: Multiple terms without an operator are combined with AND
  • #javascript #react is the same as #javascript and #react
• Grouping: Use parentheses () to control evaluation order
• Phrases: Use quotes "..." to search for exact phrases
• Tag prefix: Tags must start with #
• Sorting: Results are sorted alphabetically by title

For auto-search (empty blocks):

• Uses OR logic for frontmatter tags (matches bookmarks with ANY of the tags)
• Filters results to only include bookmarks containing at least one word from the note title
• Title words must be at least 3 characters long
• Results are ranked by: tag matches (primary), then title word matches (secondary)
• Returns top 10 most relevant results

For more details on search syntax, see the Linkding search documentation.

Display Options

Callout Wrapper

Optionally wrap bookmark results in an Obsidian callout for better visual organization:

1. Go to Settings → Linkding Bookmarks → Display
2. Enable Use callout
3. Choose Callout type (note, tip, warning, info, etc.)
4. Optionally enable Collapsed by default to start collapsed

Callouts are collapsible — click the title to expand/collapse the bookmark list. Keyboard navigation is supported (Tab to focus, Enter/Space to toggle).

Available callout types:

• note, abstract, summary, tldr
• info, todo
• tip, hint, important
• success, check, done
• question, help, faq
• warning, caution, attention
• failure, fail, missing
• danger, error
• bug, example
• quote, cite

Getting Your API Key

1. Open Linkding → Settings → Integrations
2. Copy your API key

License

MIT