| .github | ||
| .husky | ||
| docs | ||
| src | ||
| .editorconfig | ||
| .gitignore | ||
| .npmrc | ||
| .prettierrc | ||
| bun-fix.d.ts | ||
| bun.lockb | ||
| CLAUDE.md | ||
| data.json | ||
| esbuild.config.mjs | ||
| eslint.config.mjs | ||
| LICENSE | ||
| manifest.json | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| release.sh | ||
| styles.css | ||
| tsconfig.json | ||
| version-bump.mjs | ||
| versions.json | ||
Obsidian N-brace Plugin
Obsidian N-brace Plugin Homepage
A more intuitive Graph navigation and visualization for Obsidian.
See the demo: <not yet published!>
Donate if you appreciate my work! https://buymeacoffee.com/nbrace
Installation
Through community plugin store
Not yet available. Easiest option of installation is through BRAT plugin (below).
Using BRAT
- Install the Brat Plugin in Settings → Community plugins → Browse BRAT → push the Install button
- Enable BRAT in Settings → Community plugins
- Open BRAT settings and click "Add Beta plugin"
- Enter the repository URL:
nn-ninja/n-brace - Click "Add Plugin" and enable N-brace in your community plugins
BRAT will automatically check for updates and notify you when new versions are available.
Manual installation
- cd to
.obsidian/plugins - git clone this repo
cd obsidian-n-brace && bun install && bun run build- there you go 🎉
Usage
In a note tab context menu (right click), click on use N-brace to open a local graph of viewed note.
The graph appears in the right-hand view and is designed to be used alongside the note on the left. Its purpose is to help you quickly understand how the current note connects to others and to visualize its overall structure.
G-span defines how large a portion of the graph is displayed. When the number of visible nodes reaches this limit, the view automatically shrinks by hiding the most distant nodes.
Navigation
You can navigate using the keyboard arrow keys. Notes that haven’t been expanded yet in the local graph are shown with a dotted border.
If you need to explore the parent notes, hold Ctrl to reverse the navigation direction — the link directions will swap accordingly.
Notes
At present, the n-brace graph model is initialized during application startup, which may result in longer loading times.
I have in my plans to optimize this process.
Features
Local Graph
It is designed to rather operate on a local graph, not on huge and unclear global graph.
Save Setting
You can update and save your general settings.
Acknowledgement
I want to especially thank to the creators of this repos:
- Force Graph repo: https://github.com/vasturiano/force-graph
- The original 3D graph plugin: https://github.com/AlexW00/obsidian-3d-graph
- The improved version: https://github.com/HananoshikaYomaru/obsidian-3d-graph
Their work was very helpful in getting my project off the ground.