URL Schemes¶
FoldNotes registers the foldnotes:// URL scheme for deep-linking into the app.
Open a Note¶
foldnotes://open?id=<noteUUID>&collection=<collectionUUID>
foldnotes://open?title=Meeting+Notes&collection=<collectionUUID>
| Parameter | Description |
|---|---|
id |
Note UUID (from front matter) |
title |
Note title (URL-encoded) |
collection |
Collection UUID (optional — defaults to active collection) |
Open a Task¶
Opens the note and scrolls to the specific task.
| Parameter | Description |
|---|---|
id |
Task UUID (paragraph UUID) |
note |
Note UUID containing the task |
collection |
Collection UUID (optional) |
Open Today's Daily Note¶
Opens today's daily note, creating it if it doesn't exist.
Open the App¶
Brings FoldNotes to the foreground.
Collection Switching¶
When a URL includes a collection parameter pointing to a different collection:
| Scenario | Result |
|---|---|
Same collection (or no collection param) |
Opens the note directly |
| Different collection, app not running | Switches to that collection and opens the note |
| Different collection, app is running | Shows a confirmation alert before switching |
URLs without a collection parameter (e.g. from older versions) are backward compatible — they open in the current active collection.
Where Deep Links Are Generated¶
- Copy Note Link (Edit menu, Cmd+Shift+C) —
foldnotes://open?id=...&collection=... - Copy Task Link (Edit menu) —
foldnotes://task?id=...¬e=...&collection=... - Copy Link (backlink context menu) — includes collection
- Copy Link (Notes List context menu) — includes collection
- CLI (
fn open,fn daily --open,fn create --open) — includes collection
Using URL Schemes¶
From the Terminal¶
From Apple Shortcuts¶
Use a Run Shell Script action:
From the CLI¶
The fn open command uses URL schemes internally: