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 the File Explorer

Click the graph icon (circular arrows) in the Files tab header to open the Document Graph for your current project.

​

From Quick Actions

Press Cmd+K / Ctrl+K and search for “Document Graph” to open it directly.

​

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.

​

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:

​

Mouse Controls

• Click a node to select it
• Double-click a node to recenter the view on it
• Drag nodes to reposition them — positions are saved
• Scroll to zoom in and out
• Pan by dragging the background

​

Graph Controls

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

​

Depth Control

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

• Depth: 1 — Show only direct connections
• Depth: 2 — Show connections and their connections (default)
• Depth: 3+ — Show deeper relationship chains

Lower depth values keep the graph focused; higher values reveal the full document ecosystem.

​

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