Find notes and folders across every space you can open: titles as you type, the full text, and filters such as in:, by: and updated:
Press Ctrl+K (⌘+K on a Mac) anywhere in the app, or click Search at the top of the sidebar. On a narrow screen, use the magnifying glass in the top bar.
Before you type, search lists the notes you opened lately, the last one first, topped up with the notes changed most recently. Under the list, Narrow it down shows the operators you can use; click one to add it to the box. The list of recent notes is kept in this browser for your account, so another browser or computer has its own.
Start typing in Search notes, or in:Space by:me updated:<7d…. Results come in two steps:
Titles, with every key you press. Kribble matches what you type against the names of the notes in your spaces at once, without asking the server.
The full text, a moment later, from the server: headings, text, comments and the rest (see What search looks through below).
Title matching is forgiving. The letters of each word you type must appear in the title in order, but not necessarily next to each other, and the words can come in any order: dpk and kube depl both find "Deploy to Kubernetes". Case and accents don't matter. Letters spread out over a title must begin at the start of a word, so dep doesn't find "Incident response". The matching letters are highlighted. Notes you open often, and opened lately, rank higher.
The list is put together in this order:
Up to three notes whose title has every word you typed, each as the start of a word of the title.
The server's results, in its order.
Up to four looser title matches the server didn't return.
When the query has operators (see below), only the server's results are shown.
Each note in the list shows:
where it is: the space and folders, and on the right when it last changed
its name and description
the heading the match is under, with the headings above it, such as Deploying › Rollback
the text around the match, with your words highlighted. A speech-bubble icon means the match is in a comment, a paperclip that it's in the name of an attachment.
When more sections of the same note match, up to two more appear below it, each with its heading and text.
Choosing a result opens the note at the block that matched: the page scrolls to it and highlights it for a moment. A match on the title opens the note at the top. If the note is in a different organisation from the one you're in, Kribble switches to that organisation first.
Search shows the 20 best matches from the server. If what you want isn't there, add a word or an operator.
On a screen at least 1024 pixels wide, a preview beside the list shows the highlighted result: its place, name, when it was updated and its description, then the blocks around the match. The block that matched is marked with a line in the margin, and your words are highlighted. For a folder, the preview lists what is in it. The preview follows as you move through the list.
Key | What it does |
|---|---|
↓ and ↑ | Move through the results |
Enter | Open the highlighted result at the match. While you type an operator, complete the highlighted value |
Ctrl+Enter (⌘+Enter on a Mac) | Open the highlighted result in a new tab, in the background. Search stays open, so you can open several |
Tab | Complete the highlighted operator value |
Esc | Close search |
You can also click a result, or open it in a new tab with Ctrl-click (⌘-click on a Mac) or a middle-click. In the desktop app, the new tab is one of the app's tabs.
Operators go in the search box with your words, in any order: rollback in:Engineering updated:<30d. An operator on its own, without words, lists everything that matches it, most recently updated first: by:me updated:<7d shows what you changed this week.
Operator | Finds |
|---|---|
| Notes in the space Engineering. The name must match whole; if no space has it, a space whose name starts with it, so |
| Notes in that folder of that space, and in the folders under it. Quote a value that has spaces |
| When no space has the name: notes in every folder called Runbooks, in any space |
| Notes in the organisation Acme's spaces (its name, or its name in URLs). |
| Notes you created or saved a version of |
| Notes created or edited by someone whose username is |
| Changed in the last 7 days. The units are |
| Not changed in the last 30 days |
| Changed today, yesterday, or in the last week, month or year |
| Changed in that month, or on that day |
| Changed after that day, or before that month |
| Changed between the two, both included: here from 1 January to the end of March |
| Notes with a word in the title that starts with "helm" |
| Only notes, or only folders |
| Most recently updated first, least recently updated first, or by title, instead of by relevance |
| Notes with those words together, in that order |
| Leaves out notes with that word or phrase |
Some operators have other names that work the same: space: and folder: for in:, organization: and organisation: for org:, author: for by:, modified:, edited: and changed: for updated:, name: for title:, and is: for type:. Operator names and values ignore case. A word with a colon that isn't an operator, such as TODO: or a link, is searched as text.
Dates and days such as today count in your browser's time zone.
You can use several operators, and a note must match all of them. The exception is several in:, org: or by:, such as in:Engineering in:Design: these find notes that match any one of them.
If an in: names no space or folder you can open, an org: no organisation of yours, or a by: no person, search finds nothing at all and says Nothing matches those filters., instead of quietly searching everywhere. The operator's chip turns red and says why, for example "No space or folder “Enginering”". Fix the typo or remove the chip. When you give several in: (or several by:) and only some of them match, the ones that match are used.
An operator whose value isn't understood, such as updated:soon or sort:size, is ignored; its chip turns red and says which values work.
While you type an operator, the list offers its values:
in: lists your spaces and folders, matched against what you type the same forgiving way as titles: in:runb offers Engineering/Runbooks.
org: lists your organisations.
by: offers me.
updated: offers today, yesterday, <7d, <30d and >90d.
type: offers note and folder, and sort: offers recent, oldest and title.
Press Tab or Enter to take the highlighted value. A value with spaces is quoted for you.
Once the server has answered, each operator shows as a chip under the box, saying how it was understood: "In Engineering › Runbooks", "By Erik Szabo", "Updated in the last 7 days". Click the × on a chip to take that operator out of the query.
Search covers the notes and folders in every space you can open, in all your organisations, not only the one you're in. In each note it looks at:
the title
the headings
the description
the text, including code blocks. Code identifiers are also found by their words: parseJSONBody by "json body", fooBar by "bar", and snake_case and dotted.names by their parts
the names of attachments and videos, and the alt text of images
the comments
the names of the space and folders the note is in, so "runbooks rollback" finds a note called "Rollback" in a Runbooks folder
Small typos are forgiven, and a word you're still typing matches the words it starts: deplo finds "deploying".
Kribble detects the language of each note when it's saved, from the note's own words, so a space can mix languages: English notes beside Hungarian ones, for example. Search then also finds the other forms of the words you type in each note's language: deployments finds a note that only says "deploying", and beállításaid finds "Beállítások". Your words are tried in every language your notes are in; you don't choose one. Notes found only this way come after every note that has your words as you typed them (or with a small typo), so the results you'd have had anyway don't move down.
Languages with this: English, Hungarian, German, French, Spanish, Italian, Portuguese, Dutch, Swedish, Norwegian, Danish, Finnish, Romanian, Russian, Polish and Czech. A note too short to tell its language (a few words), or whose languages are too evenly mixed, is searched only by its words as written.
Accents don't have to be typed: kozlekedes finds "Közlekedés". But when you do type them, notes with the word exactly as you typed it come first: kör puts a note about a kör (circle) before notes that say kor or kórház.
Unless you use sort:, the server ranks notes by, in order:
How many of your words they contain. Notes with all of them come first.
Fewer typos.
Your words close together.
Where they matched: the title counts most, then headings, the description, the text, code identifiers, the space and folder names, attachment names, and last comments. A note called "Deploying" comes before a note that mentions deploying in passing.
Exact words before words that only start the same.
The note changed most recently.
Then notes with your words with the accents as you typed them come before notes with them only with other accents, and notes found only by another form of a word (see above) come last.
In the search box, the title matches described in As you type come before the server's ranking.
Search finds what has been saved. Changes you're still editing, and drafts kept in your browser, don't show up until you click Save.
In the editor, typing :note-link[[ matches note titles in the current organisation, the same forgiving way, so you can link to one (see [Writing notes]{noteId="01a134d9-9edc-7aaf-b015-8a701ea44670"}).
The home page lists the notes changed most recently, and each space and folder page lists what changed in it lately.
The kribble CLI searches with the same operators from a terminal, and can search markdown files on your computer without a server. The desktop app searches every connected server from anywhere on your computer.