ekphosv0.20.0

Graph View

Visualize connections between your notes with wiki links

The Graph View provides a visual representation of your notes and their connections through wiki links. Press Ctrl+g to open the graph.

Graph View

Overview

The graph displays:

  • Nodes: Each note in your vault appears as a small square with its title below
  • Edges: Dotted lines connecting notes that link to each other via [[wiki links]]
  • Selection highlighting: When a node is selected, its connected edges are highlighted

The graph uses a force-directed layout that automatically positions notes based on their link relationships, with connected notes pulled closer together.

KeyAction
h / lSelect node left/right
j / kSelect node down/up
gSelect first node
GSelect last node
uUnselect current node
EnterOpen selected note
EscClose graph view

Panning & Zoom

KeyAction
HPan left
JPan down
KPan up
LPan right
+ / =Zoom in
-Zoom out
fFit graph to screen
0Reset zoom to 100%

Moving Nodes

You can manually reposition nodes to customize your graph layout:

KeyAction
Ctrl+hMove selected node left
Ctrl+jMove selected node down
Ctrl+kMove selected node up
Ctrl+lMove selected node right

Mouse Controls

ActionResult
Click nodeSelect the node
Drag nodeMove the node
Drag backgroundPan the view
Scroll upZoom in
Scroll downZoom out

Understanding the Layout

The graph uses a force-directed algorithm that:

  1. Attracts linked notes: Notes connected by wiki links are pulled closer together
  2. Repels overlapping nodes: Nodes push away from each other to avoid overlap
  3. Balances the layout: The algorithm finds an equilibrium where forces are balanced

The layout calculates when you open the graph view and automatically fits to screen. Manual node movements will push nearby nodes away to prevent overlap.

Tips

  • Use wiki links ([[note name]]) to create connections between notes
  • The graph helps identify orphan notes (no connections) and hub notes (many connections)
  • Press Enter on any node to quickly jump to that note

On this page