Document Graph

The Document Graph provides an interactive visualization of your markdown files and their connections. See how documents link to each other through wiki-links ([[link]]) and standard markdown links, making it easy to understand your documentation structure at a glance.

​

Opening the Document Graph

There are several ways to access the Document Graph:

​

From File Preview

When viewing a markdown file in File Preview, press Cmd+Shift+G / Ctrl+Shift+G to open the Document Graph focused on that file. Press Esc to return to the File Preview. This is the primary way to open the Document Graph.

​

From Quick Actions

Press Cmd+K / Ctrl+K and search for “Open Last Document Graph” to re-open the most recently viewed graph.

​

From the File Explorer

After you’ve opened a Document Graph at least once, a graph icon (branch icon) appears in the Files tab header. Click it to re-open the last viewed graph.

​

From File Context Menu

Right-click any markdown file in the File Explorer and select Document Graph to open the graph focused on that file.

​

Using Go to File

Press Cmd+G / Ctrl+G to open the fuzzy file finder, navigate to any markdown file, then use Cmd+Shift+G to jump to the Document Graph from there.

​

Navigating the Graph

The Document Graph is designed for keyboard-first navigation: L steps through Mind Map, Radial, Hierarchical, and Force, in the same order as the layout dropdown. D widens the depth one level per press (1 through 5, then All, then back to 1).

​

Mouse Controls

• Click a node to select it
• Double-click a node to recenter the view on it
• Drag nodes to reposition them
• Scroll to zoom in and out
• Shift+Scroll to pan the canvas
• Pan by dragging the background
• Mini-map in the bottom-left corner shows the whole graph; click or drag on it to jump the main view to that spot
• Drag the left edge of the in-graph document preview to make it wider or narrower; the width is remembered. Double-click that edge to restore the default.

​

Graph Controls

The toolbar at the top of the Document Graph provides several options:

​

Depth Control

Adjust the Depth slider to control how many levels of connections are shown from the focused document:

• Depth: 0 (All) - Show all connected documents regardless of distance
• Depth: 1 - Show only direct connections
• Depth: 2 - Show connections and their connections (default)
• Depth: 3-5 - Show deeper relationship chains

Lower depth values keep the graph focused and improve performance; higher values reveal more of the document ecosystem. The depth can be adjusted from 0 (All) to 5. Press D to widen it one level per press without opening the slider.

​

Layout

The layout dropdown switches how nodes are arranged: Mind Map (tree columns), Radial (concentric rings), Hierarchical (top-down rows), and Force (physics simulation). Press L to step through them in that order. Switching layouts clears any nodes you dragged, since those positions belong to the layout they were set in.

​

External Links

Toggle External to show or hide external URL links found in your documents:

• Enabled - External links appear as separate domain nodes (e.g., “github.com”, “docs.example.com”)
• Disabled - Only internal document relationships are shown

External link nodes help you see which external resources your documentation references.

​

Search

Use the search box to filter documents by name. Matching documents are highlighted in the graph.

​

Understanding the Graph

​

Node Types

• Document nodes - Your markdown files, showing the filename and a preview of content
• External link nodes - Domains of external URLs referenced in your documents
• Focused node - The currently selected document (highlighted with a different border)

​

Edge Types

Lines between nodes represent different types of connections:

• Wiki-links - [[document-name]] style links
• Markdown links - [text](path/to/file.md) style links
• External links - Links to URLs outside your project

​

Node Information

Each document node displays:

• Filename - The document name
• Folder indicator - Shows the parent directory (e.g., “docs”)
• Content preview - A snippet of the document’s content

​

Tips for Effective Use

​

Workflow Integration

1. Use Cmd+G to quickly find a file
2. Open it in File Preview to read or edit
3. Press Cmd+Shift+G to see its connections in the Document Graph
4. Press O to open a connected document
5. Press Esc to return to File Preview

​

Large Documentation Sets

For projects with many markdown files:

• Start with Depth: 1 to see immediate connections
• Increase depth gradually to explore relationships
• Use Search to find specific documents quickly
• Drag nodes to organize the view - positions persist

​

Understanding Documentation Structure

The Document Graph is especially useful for:

• Auditing links - Find orphaned documents with no incoming links
• Understanding navigation - See how documents connect for readers
• Planning restructuring - Visualize the impact of moving or renaming files
• Onboarding - Help new team members understand documentation architecture

​

Keyboard Shortcut Summary