---
title: "Busca e Spotlight"
description: "Salto rápido até uma nota pelo Spotlight e pelo OmniSearch, além da filtragem por texto no Feed."
---

# Busca e Spotlight

O Notarium tem duas superfícies de busca distintas, e vale a pena distingui-las desde o início. O **Spotlight** e o **OmniSearch** são de salto rápido (quick-jump): você digita parte de um título e vai direto para a nota que procura. O **filtro por texto do Feed** (`?q=`) é busca no corpus: ele restringe a lista de notas e se combina com filtros por pasta, tag e data. Em resumo: um é "saltar até uma nota", o outro é "filtrar a seleção".

## Spotlight — saltar até uma nota

O Spotlight é um painel centralizado, comandado pelo teclado, que aparece sobre a página. Dá para abri-lo de três formas, e todas as três levam ao mesmo painel:

- **Cmd/Ctrl+P** — o alternador rápido (Spotlight);
- o ícone de **busca** na barra lateral esquerda;
- a tecla de atalho **`/`**.

> [!tip] O layout do teclado não atrapalha
> O painel escuta a tecla física, não o caractere. Num layout cirílico, `Cmd/Ctrl+P` (onde essa tecla física produz a letra cirílica *ze*) e `/` funcionam exatamente como num layout latino.

Como o painel se comporta:

- **Consulta vazia → "Recentes".** Primeiro vêm as notas que você **abriu** recentemente (a lista é mantida por espaço), depois as recentemente **modificadas** completam. A primeira tarefa do alternador rápido é trazer você de volta para onde acabou de estar.
- **Digitar → notas.** Cada tecla refina os resultados por busca híbrida (léxica + semântica onde a busca vetorial está ativada; um graph boost sobre os links é um canal extra, desativado por padrão; sem busca vetorial, a consulta recai na busca de texto completo — sem erro). As correspondências ficam destacadas no título e no trecho.
- **Cada linha de resultado** mostra uma data e o caminho da pasta pai, para você distinguir notas que compartilham o mesmo nome.
- **Teclado:** `↑`/`↓` para selecionar, `Enter` para abrir, **Cmd/Ctrl+Enter** para abrir numa nova aba, `Esc` para fechar.

![Spotlight: correspondências realçadas, com a data e a pasta pai em cada linha de resultado](/media/app-search-light.webp)

O Spotlight opera dentro do **espaço ativo**: ele busca notas no espaço atual.

## OmniSearch — o campo da barra superior

O **OmniSearch** é o mesmo campo de busca, deslocado para o centro da barra superior em telas largas. Ele compartilha os dados de sugestão com o Spotlight: conforme você digita, os mesmos resultados de salto rápido surgem logo abaixo. A linha superior "buscar no Feed" (ou simplesmente `Enter`) entrega a consulta ao **Feed** como um filtro por texto `?q=`.

O campo é uma conveniência para monitores grandes: em telas estreitas, ele fica totalmente oculto. Isso não representa perda de acesso — a busca está sempre a um gesto de distância pelo ícone da barra lateral, `Cmd/Ctrl+P` e `/`.

## O filtro por texto do Feed

No [Feed](/docs/guides/feed/), a consulta `q` é um terceiro eixo de filtro ao lado das pastas e das tags: uma única linguagem de consulta, `pasta ∧ tag ∧ texto`. Aqui o que importa é a **ocorrência dos termos**, não a proximidade semântica: o filtro usa o canal de busca léxica (texto completo), então um "vizinho semântico" sem uma palavra em comum não entra na seleção. A consulta vive na URL (`?q=`), enquanto a janela do Feed, o contador exato `total` e o histograma por datas descrevem exatamente essa seleção restringida.

Para entender como a própria busca híbrida funciona por baixo dos panos, veja [Busca](/docs/concepts/search/). Os atalhos de teclado para abri-la estão na página [Atalhos de teclado](/docs/guides/hotkeys/).