diff --git a/apps/website/content/obsidian/core-features/_meta.ts b/apps/website/content/obsidian/core-features/_meta.ts index 485924fe0..594fdbe28 100644 --- a/apps/website/content/obsidian/core-features/_meta.ts +++ b/apps/website/content/obsidian/core-features/_meta.ts @@ -6,6 +6,7 @@ const meta: MetaRecord = { "discourse-context": "Discourse context", canvas: "Canvas", "node-tags": "Node tags", + "node-search": "Node search", "querying-discourse-graph": "Querying", }; diff --git a/apps/website/content/obsidian/core-features/node-search.md b/apps/website/content/obsidian/core-features/node-search.md new file mode 100644 index 000000000..f01c93df5 --- /dev/null +++ b/apps/website/content/obsidian/core-features/node-search.md @@ -0,0 +1,60 @@ +--- +title: "Node search" +date: "2026-08-23" +author: "" +published: true +--- + +**Node search** is a dedicated surface to search and interact with discourse nodes in your vault. + +## Open the search + +1. Open the command palette with `Cmd/Ctrl + P` +2. Search for "node search" and select **Discourse Graph: Open node search** + +![Node search modal with ranked results and a preview](/docs/obsidian/node-search-results.png) + +## Filter by node type + +There are two ways to narrow results to particular node types. Both drive the same filter, so you can start with one and finish with the other. + +### From the filter dropdown + +Click the funnel icon to the right of the search field and tick the node types you want. + +![Node type filter dropdown](/docs/obsidian/node-search-type-filter.png) + +- **Only** — appears when you hover or focus a row, and narrows the filter to that single type +- **Clear filter** — removes the filter entirely and shows the count of types currently selected +- A **Filter types…** box appears once you have more than seven node types configured, so a long list stays manageable + +A badge on the funnel icon shows how many types are selected. Selecting every type is the same as selecting none — both show all your nodes. + +### From the keyboard, as tag chips + +Start typing a node type's name in the search field and its full name appears as ghost text with a `Tab` hint. + +![Typing a node type name shows a Tab completion hint](/docs/obsidian/node-search-type-completion.png) + +Press `Tab` to turn it into a chip. The search field clears so you can immediately type another type name, or start typing the title you're actually looking for. + +![Two node type chips beside a search query](/docs/obsidian/node-search-type-chips.png) + +## Sort the results + +Click the sort icon to choose how results are ordered. + +![Sort dropdown with five dimensions and direction toggle](/docs/obsidian/node-search-sort.png) + +Notes with no resolvable author sort after every named author, in both directions. + +## Act on a result + +The footer shows what you can do with the highlighted result, and every action there is clickable as well as keyboard-driven. + +| Action | Shortcut | +| ------------------------------------------ | -------------- | +| Insert a link to the result at your cursor | `Cmd/Ctrl + ↵` | +| Open the result in a new tab | `↵` | +| Open the result in a split | `Shift + ↵` | +| Close the search | `Esc` | diff --git a/apps/website/public/docs/obsidian/node-search-results.png b/apps/website/public/docs/obsidian/node-search-results.png new file mode 100644 index 000000000..414e61257 Binary files /dev/null and b/apps/website/public/docs/obsidian/node-search-results.png differ diff --git a/apps/website/public/docs/obsidian/node-search-sort.png b/apps/website/public/docs/obsidian/node-search-sort.png new file mode 100644 index 000000000..5d1172c74 Binary files /dev/null and b/apps/website/public/docs/obsidian/node-search-sort.png differ diff --git a/apps/website/public/docs/obsidian/node-search-type-chips.png b/apps/website/public/docs/obsidian/node-search-type-chips.png new file mode 100644 index 000000000..2bf1ce505 Binary files /dev/null and b/apps/website/public/docs/obsidian/node-search-type-chips.png differ diff --git a/apps/website/public/docs/obsidian/node-search-type-completion.png b/apps/website/public/docs/obsidian/node-search-type-completion.png new file mode 100644 index 000000000..2abd47c4e Binary files /dev/null and b/apps/website/public/docs/obsidian/node-search-type-completion.png differ diff --git a/apps/website/public/docs/obsidian/node-search-type-filter.png b/apps/website/public/docs/obsidian/node-search-type-filter.png new file mode 100644 index 000000000..10e7237e2 Binary files /dev/null and b/apps/website/public/docs/obsidian/node-search-type-filter.png differ