Cross-Linking
Maintain bidirectional links for discoverability and graph navigation.
What to Link
Always Link
| Content Type | Link To | Example |
|---|---|---|
| People | Person profile | [[Alice Smith]] not "Alice" |
| Projects | Project README | [[AGI-Assistant]] |
| Tasks | Task file | [[Integrate-Zep-Memory]] |
| Meetings | Meeting note | [[2026-01-12 Weekly Sync]] |
| Tools/Tech | Research entry | [[Zep]], [[LangChain]] |
On First Mention
Link concepts, tools, and references on their first appearance in a document.
Link Syntax
Basic Wikilink
markdown
[[Page Name]]
With Display Text
markdown
[[Page-Name|Display Text]] [[Team/Alice-Smith|Alice]]
With Relative Path
markdown
[[../Team/Alice-Smith|Alice Smith]] [[../../04-Knowledge/AI-Ecosystem/Zep|Zep]]
Finding Related Content
By Topic
Search for related pages in the same category:
- •AI tools →
04-Knowledge/AI-Ecosystem/ - •Projects →
03-Projects/ - •Team →
01-Team/
By Tag
Find pages with similar tags:
code
#project/agi-assistant #topic/ai #team/member
By Existing Links
Check what the page already links to, then find related pages that should also be linked.
Linking Checklist
When creating/editing content:
- •People mentioned? → Link to profiles in
01-Team/ - •Projects referenced? → Link to project READMEs
- •Tasks discussed? → Link to task files
- •Tools/tech mentioned? → Link to AI-Ecosystem entries
- •Related knowledge? → Link to relevant research pages
- •Meetings referenced? → Link to meeting notes
Bidirectional Linking
Obsidian automatically creates backlinks, but for better navigation:
- •Link from new page to existing related content
- •Consider updating related pages to link back (for important connections)
Common Link Targets
Team
- •Link to team member profiles in
Database/People/
Projects
- •Link to project documentation in
Projects/orDatabase/Projects/
AI Ecosystem Categories
- •
[[Agent-Frameworks]] - •
[[LLM-Providers]] - •
[[Developer-Tools]] - •
[[MCP-Ecosystem]] - •
[[Vector-Databases]]
Example
Before:
markdown
Alice is working on the authentication integration for our web app project.
After:
markdown
[[Alice Smith]] is working on the [[OAuth]] integration for our [[Web App]] project.