Appearance
Search
Full-text search over the workspace, in two sizes.
The sidebar box — finding a page you know is there
Type in the box at the top of the sidebar and a few hits appear beneath it, gone when the box is cleared. A page whose title matches ranks above one that only mentions the words in passing.
The search page — reading what the workspace says
Press Enter in the sidebar box, choose All results, by page, pick Search the workspace in the palette, or press Ctrl+Shift+F anywhere. Search then takes the main area, like the timeline:
- Every match, grouped by the page it is on. Pages come in the order of their best match, each saying how many it holds, and More results fetches the next page of them.
- Options: only under the page you have open, and archived pages too. Changing either asks the question again rather than filtering the answer you already have.
- The question is in the address (
?view=search&q=…), so a search can be reloaded, bookmarked and sent to somebody. - A result opens its page at the block that matched, scrolled into view and marked for a moment. If the block was folded away, the fold opens. A page written as Markdown opens at the top.
- Back returns to the same results at the same scroll.
Ctrl F with the caret in a page is still find in the page.
What it searches
The current text of every block you may read, plus page titles. Search runs against what each page says now, not against every version of every sentence that ever existed. For the latter, use the timeline, which is the view built for asking questions about time.
Archived pages are left out unless you ask for them. Filtering by author, block type or the date something was written is not offered: today's search index records none of those.
Permissions are part of the query
You get hits only from pages you may read, and that filtering happens inside the query rather than afterwards.
The difference is not cosmetic. Filtering results afterwards leaks the existence and rough volume of what you cannot see, and it produces short and empty result pages that look like a broken index. Results are paged with a cursor rather than an offset, so writing that lands while you read never makes a result appear twice or vanish.
Scope
Search covers one workspace — the one you are in. Pages in other workspaces that have been shared with you are opened at the owning workspace's address, and are searched there.
A published site has a search box of its own, which finds words on that site's pages and nowhere else.
Finding a block rather than a page
Two other searches exist, with their own triggers, both described elsewhere:
[[searches pages, to link one. See links.((searches blocks, to reference one. See block references.