Home

folea

folea is a desktop reader and navigator for Typst notes. A vault is a normal directory of .typ files.

folea renders notes, searches them, shows their links and headings, and manages files in the vault. It does not edit note text. Ctrl+e opens the current note in an external editor.

Start here

1. Install folea and open a vault.
2. Read Features for everyday tasks.
3. Keep the Keyboard Reference nearby.
4. Set your editor and preferences in Configuration.

Useful first keys

Key	Action
Ctrl+p	Open a recent note or search note contents
Ctrl+b	Toggle the file tree
/	Search the current note
:	Open the command palette
Ctrl+e	Open the current note in your editor
j / k	Scroll down / up
Space / Shift+Space	Scroll half a screen down / up
o	Open the heading outline
b	Show backlinks and outgoing links
s	Enter rendered-text caret mode

Bindings use Ctrl, not Cmd/Meta. See Keyboard Reference for every context and command ID.

What is saved

folea remembers recent vaults, the last note, recent notes, per-note scroll and zoom, command-palette history, and the last chosen template. Rendered notes are cached under the vault so they can open without recompiling when the cache is still valid.

See Caching and State for file locations and limits.

Limits worth knowing

• Only .typ notes are indexed.
• The tree hides any path with a dot-prefixed segment.
• Vault search uses ripgrep, respects ignore files, and normally skips hidden paths.
• The link graph understands literal double-quoted #link, #import, and #include targets. It does not index wiki links or dynamic Typst expressions.
• Files inside ignored directories, including _templates, are not watched for live updates.

See Troubleshooting when a note, search result, link, or live update is missing.