Docs

Search

How Blocknotik search works, its syntax (phrases, exclusions, tags), how results are ordered and what to expect from it on large folders.

On this page
  1. Syntax
  2. How words are matched
  3. Order of results
  4. Keys
  5. How fast is it?
  6. What search doesn't cover

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

QueryFinds notes that…
ryecontain “rye” anywhere, in the title or the text
rye startercontain both words, in any order and place
"rye flour"contain this exact sequence of characters
-breaddo not contain “bread” (combine with other words)
-"white bread"do not contain the phrase
tag:kitchen or #kitchenhave the tag #kitchen or a nested one like #kitchen/baking
-tag:shoppingdo 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, rye and RYE are the same.
  • Parts of words match. rye also finds ryes, plan finds 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 ёлка and strasse finds Straße. Umlauts are not folded: kuche doesn'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:

  1. A word that appears in the title counts a lot; an exact title match even more.
  2. 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).
  3. 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 .txt files 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.