Search Syntax Cheatsheet
Term
Enter a single term in the search field to show only notes containing the term in the text content, title or tags.
E.g.
Typing “cat” will cause only notes containing “cat” in the text, title, or tags to be shown.
Multiple Terms
If you enter multiple terms, notes will be shown that include all of them.
E.g.
Typing cat dog will show notes which match both “cat” and “dog”.
Tag
Entering a term will also search a note’s tags. If you want to restrict the search to only tags, use a # symbol.
E.g.
To search for notes containing the tag “cat”, enter #cat in the search field.
Person
Entering a term will also search a note’s person tags. If you want to restrict the search to only person tags, use a @ symbol.
E.g.
To search for notes containing the tag “Bob”, enter @Bob in the search field.
Tag with Parameter
You can include a parameter in your tags, such as #color(green). If you enter “color”, you get all notes which include the tag color, regardless of the parameter. If you include a parameter in the search, only tags with that parameter will match.
E.g.
Entering #color will match a note with #color(green), as well as a note with #color(yellow).
Entering #color(green) will only match notes containing the tag #color(green).
Due Tag
The tag “due” is special: it can be given a date as a parameter. The date can be absolute, like “due(22 Jan 2018)”, but it can also be relative. If a relative date is entered, it is converted to an absolute date. E.g. If you type #due(tomorrow), Agenda will automatically replace tomorrow with the date of the next day.
When searching, you can enter a due tag with a date. This will match any note that contains a due tag with a date that precedes or coincides with the one in the search field.
E.g.
If you enter the search term #due, it will match any note containing a due tag.
If you enter the search term #due(22 Jan 2018), it will show any note that has a due tag on or before the 22nd January, 2018.
Stars
To search for a note that contains a star, enter the tag #star in the search field.