docs / finding

Finding things.

There are two ways to look for something. ⌘K is for going somewhere. / is for reading across your notes. Tags, links and people connect notes to each other; tag pages, backlinks, the sidebar and the graph show those connections.

The list

Home shows everything, newest first, in one flat list. Fragments are shown whole. Notes show a title and their opening lines, their todos drawn as [ ] / [x], and up to two of their images.

There are no day headers. The date shows in the gutter once, on the first row of each day, and today's date is in the accent colour.

KeyDoes
j / knext / previous
gg / Gtop / bottom
[d / ]dprevious / next day
⏎open
xpin the row to the top, or unpin it
iback to the capture box

The mouse works too: click a row to open it. The same keys work in every list: tag pages, :notes, :pinned and :orphans.

Your theme picks one of two layouts for the list. Ledger puts the date in the gutter and the note beside it. Stream shows one card per note, with the time on the right and no gutter.

More lists

CommandLists
:notesevery note, newest first
:notes --asc / :notes --descevery note, by title
:pinnedpinned notes and fragments
:orphansnotes with no links in or out

⌘K, summon

Press ⌘K from anywhere, type a few letters, and press ⏎. One list holds notes, fragments, tags and commands, ranked by how well they match, with the matched part marked. There are no section headers.

KeyDoes
↑ ↓ or ⌃n ⌃pmove
⏎open, or run a command
# firsttags only
@ firstpeople only
⌃rrename the selected tag or username everywhere

# first lists only tags, ranked by how recently and how often you use them (14 · today). There's no "all tags" page; this is it. @ first lists only people, and outside a note gp opens summon on that list.

Renaming a tag everywhere

Select a tag in ⌘K and press ⌃r. Paperkites renames it in every file that uses it, child tags included, as one operation: every file changes or none does. :undo puts it all back.

Press /, type, and press ⏎. Paperkites searches the text of every note. Results are grouped by note, one line per match, with the term highlighted.

KeyDoes
n / Nnext / previous match, across notes
⏎open the note at the match

Narrow a search by adding these to the query:

AddSearches only
#gardennotes tagged #garden
@dashanotes that mention @dasha

For example, /soil #garden finds "soil" only in notes tagged #garden. In a note, press esc before /, or it types into the note.

Tag pages

Open a tag's page with :tag garden, with gt on a tag in a note, or from ⌘K. A tag page shows:

Notes without tags: #empty_kite

Every note and fragment without a tag carries a built-in tag, #empty_kite. Use it to find what you haven't sorted yet:

It's virtual: it's never written into a file, and it can't be renamed.

At the foot of every note, Linked from lists each note that links to it, with the sentence the link sits in.

Pinned notes

Pin a note to keep it at the top of the lists.

Back and forward

⌃o and ⌃i go back and forward through where you've been, like a browser. Outside typing, ⌃h and ⌃l do the same. gh goes home from anywhere.