Skip to content
Atlas Help

Linking Notes

One of the most powerful things you can do in Atlas is connect your notes to each other. Linked notes form a web of ideas that Atlas can navigate, reason about, and surface when it’s relevant.

Section titled “Wiki-links”

A wiki-link connects one note to another. Type double square brackets around any note name:

[[Note Name]]

For example:

Today I had a meeting with [[Sarah Chen]] about the [[Product Roadmap]].
We discussed the [[Q1 Goals]] and agreed to revisit [[Pricing Strategy]].

Wiki-links:

  • Create a clickable link in the rendered view
  • Tell Atlas that these notes are related to each other
  • Appear in your network graph as connections between nodes

Custom display text:

[[Technical Roadmap|the roadmap]]

This links to the “Technical Roadmap” note but displays as “the roadmap.”

Why linking matters

Section titled “Why linking matters”

When you link notes, Atlas builds a knowledge graph — a map of how your ideas, people, and projects connect. This graph has several practical benefits:

  • Context in chat: When you ask about a topic, Atlas can follow links to related notes and bring in relevant context automatically
  • Discovery: Atlas can show you notes you might have forgotten about when they’re relevant to what you’re working on
  • Connections: Discovering that two apparently separate notes are linked can surface insights you didn’t realize you had

The more you link, the more useful your vault becomes over time.

Section titled “Finding related notes”

You can ask Atlas to find notes related to what you’re currently working on:

“What notes are related to the Product Roadmap?”

“Find notes connected to Sarah Chen.”

“What have I written about machine learning?”

Atlas uses semantic similarity (meaning-based search) to find related notes, not just exact keyword matches. It understands that a note about “sprint planning” is related to one about “quarterly goals” even if they don’t share the same words.

Section titled “Suggesting links”

Atlas can scan a note and suggest wiki-links to other notes in your vault using its suggest_links tool. The suggestions are based on semantic similarity — Atlas looks for notes with overlapping meaning and purpose.

To use it, ask:

“Suggest links for my Project Brief note.”

“What notes should I link from my meeting notes today?”

Atlas will return a list of suggested wiki-links with a short explanation of why each one is relevant. You can add the ones that make sense.

Section titled “Semantic link insertion”

The add_semantic_links tool goes one step further — it not only finds related notes but can insert the wiki-links directly into your note where they fit naturally. Ask:

“Add semantic links to my Research Summary note.”

Atlas will read the note, find relevant connections in your vault, and insert [[wiki-links]] at appropriate points in the text.

Orphan notes

Section titled “Orphan notes”

An orphan note is a note that no other note links to. It’s an island — nothing points to it, so it’s easy to forget it exists.

Atlas can find your orphan notes:

“Find my orphan notes.”

“Which notes in my Work folder have no incoming links?”

Review the list and consider whether each orphan should be linked from somewhere, merged into another note, or archived.

Viewing the network graph

Section titled “Viewing the network graph”

The People & Network tab includes a network graph that visualizes the connections between your notes, people, organizations, and topics. Nodes represent entities; edges represent wiki-links and relationships.

Use the graph to:

  • Spot clusters of tightly related notes
  • Find notes that bridge different topics
  • Discover isolated notes that might need better connections

See Network Graph for more detail on how to use it.