Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions apps/website/content/obsidian/core-features/_meta.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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",
};

Expand Down
60 changes: 60 additions & 0 deletions apps/website/content/obsidian/core-features/node-search.md
Original file line number Diff line number Diff line change
@@ -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` |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.