From 5656e394d3d879d9cd48c18400cd7ce4c12f416e Mon Sep 17 00:00:00 2001 From: Mohamed Bassem Date: Mon, 26 Jan 2026 00:50:55 +0000 Subject: feat(search): add tag: alias for # and ! alias for negation (#2425) Add `tag:` as an alternative syntax to `#` for tag search queries, and `!` as an alternative to `-` for negating qualifiers. This provides more intuitive syntax options for users who prefer text-based qualifiers over special characters. Co-authored-by: Claude --- docs/docs/04-using-karakeep/search-query-language.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) (limited to 'docs') diff --git a/docs/docs/04-using-karakeep/search-query-language.md b/docs/docs/04-using-karakeep/search-query-language.md index a1e830e8..de11e533 100644 --- a/docs/docs/04-using-karakeep/search-query-language.md +++ b/docs/docs/04-using-karakeep/search-query-language.md @@ -11,7 +11,7 @@ Karakeep provides a search query language to filter and find bookmarks. Here are - Use spaces to separate multiple conditions (implicit AND) - Use `and`/`or` keywords for explicit boolean logic -- Prefix qualifiers with `-` to negate them +- Prefix qualifiers with `-` or `!` to negate them (e.g., `-is:archived` or `!is:archived`) - Use parentheses `()` for grouping conditions (note that groups can't be negated) ## Qualifiers @@ -29,8 +29,8 @@ Here's a comprehensive table of all supported qualifiers: | `url:` | Match bookmarks with URL substring | `url:example.com` | | `title:` | Match bookmarks with title substring | `title:example` | | | Supports quoted strings for titles with spaces | `title:"my title"` | -| `#` | Match bookmarks with specific tag | `#important` | -| | Supports quoted strings for tags with spaces | `#"work in progress"` | +| `#` or `tag:` | Match bookmarks with specific tag | `#important` or `tag:important` | +| | Supports quoted strings for tags with spaces | `#"work in progress"` or `tag:"work in progress"` | | `list:` | Match bookmarks in specific list | `list:reading` | | | Supports quoted strings for list names with spaces | `list:"to review"` | | `after:` | Bookmarks created on or after date (YYYY-MM-DD) | `after:2023-01-01` | @@ -66,6 +66,12 @@ is:archived and (list:reading or #work) # Find bookmarks that are not favorited and not archived -is:fav -is:archived + +# Using ! as an alias for negation +!is:fav !is:archived + +# Using tag: as an alias for # +tag:important tag:"work in progress" ``` ## Text Search -- cgit v1.2.3-70-g09d2