Docs
Search
How Blocknotik search works, its syntax (phrases, exclusions, tags), how results are ordered and what to expect from it on large folders.
The search box at the top looks through the titles and the text of every note. Results appear as you type; there's no button to press.
Syntax
| Query | Finds notes that… |
|---|---|
rye | contain “rye” anywhere, in the title or the text |
rye starter | contain both words, in any order and place |
"rye flour" | contain this exact sequence of characters |
-bread | do not contain “bread” (combine with other words) |
-"white bread" | do not contain the phrase |
tag:kitchen or #kitchen | have the tag #kitchen or a nested one like #kitchen/baking |
-tag:shopping | do not have that tag |
Everything combines with AND: tag:kitchen rye -bread means “tagged kitchen, mentions rye, doesn't mention bread”. There is no OR and no wildcards.
How words are matched
- Case doesn't matter:
Rye,ryeandRYEare the same. - Parts of words match.
ryealso finds ryes,planfinds planning and airplane. This is also why search works reasonably for languages with many word endings:ржанfinds ржаная, ржаной, ржаную. - Small spelling differences are folded: ё is treated as е and German ß as ss, so
елкаfinds ёлка andstrassefinds Straße. Umlauts are not folded:kuchedoesn't find Küche. - Markdown symbols are part of the text. Searching for
**bold**looks for the asterisks too.
Order of results
Results are sorted by a simple score:
- A word that appears in the title counts a lot; an exact title match even more.
- Then how often the words appear in the text (up to ten times per word, so one long note can't push everything else away).
- Among equal scores, the most recently changed note comes first.
The list shows up to 200 results with an excerpt around the first match. The line above the list tells you how many notes were found and how long the search took.
Keys
- Ctrl+K (on a Mac Cmd+K) jumps into the search box from anywhere.
- Enter opens the first result.
- Esc clears the search and shows all notes again.
- Clicking a tag in the sidebar fills in
tag:…for you.
How fast is it?
Blocknotik keeps the text of all notes in memory and goes through it on every query — there is no index on disk to build, update or repair. On a folder of 5,000 notes with about 2 KB of text each (10 MB in total), one query takes around 20 milliseconds on a modest four-core mini PC. A few hundred notes take about a millisecond.
The cost is memory: roughly twice the size of your notes. For most people's notes that is a few megabytes. If your folder holds hundreds of megabytes of text, search will get slower and Blocknotik is probably not the right tool yet. More about this choice in Search without an index.
What search doesn't cover
- Files that are not
.md(for example.txtfiles you dropped into the folder) — import them to turn them into notes. - Hidden folders, including
.trash. - Text inside images or PDFs.
- Notes larger than 8 MB are skipped entirely.