diff options
| author | Mohamed Bassem <me@mbassem.com> | 2026-01-26 00:50:55 +0000 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2026-01-26 00:50:55 +0000 |
| commit | 5656e394d3d879d9cd48c18400cd7ce4c12f416e (patch) | |
| tree | a3744e6cd640c09151b3bb1f32d23cbc50e6d084 /docs | |
| parent | af3a587acaf641007c410e61579eeefe4836e8d7 (diff) | |
| download | karakeep-5656e394d3d879d9cd48c18400cd7ce4c12f416e.tar.zst | |
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 <noreply@anthropic.com>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/docs/04-using-karakeep/search-query-language.md | 12 |
1 files changed, 9 insertions, 3 deletions
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:<value>` | Match bookmarks with URL substring | `url:example.com` | | `title:<value>` | Match bookmarks with title substring | `title:example` | | | Supports quoted strings for titles with spaces | `title:"my title"` | -| `#<tag>` | Match bookmarks with specific tag | `#important` | -| | Supports quoted strings for tags with spaces | `#"work in progress"` | +| `#<tag>` or `tag:<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:<name>` | Match bookmarks in specific list | `list:reading` | | | Supports quoted strings for list names with spaces | `list:"to review"` | | `after:<date>` | 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 |