Automatic Backlinks ¶

Backlinks are XLog’s most powerful knowledge-base feature. They automatically create bidirectional connections between pages, turning your markdown files into an interconnected knowledge graph.

What Are Backlinks? ¶

When you mention a page name in your markdown, XLog automatically:

1. Creates a clickable link to that page
2. Shows on the target page that you linked to it (backlink)
3. Builds a knowledge graph of relationships between concepts

This happens automatically - no manual link creation or management required.

How Backlinks Work ¶

Automatic Page Linking ¶

Simply mention a page name in your text (using the page filename without extension):

1I'm learning about [Neural Networks](/Neural_Networks) and [Machine Learning](/Machine_Learning).
2
3This concept relates to [Graph Theory](/Graph_Theory).

XLog automatically converts these to links. If the target page doesn’t exist yet, XLog creates a placeholder that you can click to create the page.

Bidirectional Relationships ¶

Unlike traditional hyperlinks (which only go one way), backlinks create two-way connections:

On your current page:

1[Neural Networks](/Neural_Networks) are inspired by biological neurons.

On the Neural Networks page:
XLog automatically shows:

Backlinks:
- Introduction to Machine Learning (this page links here)

This reveals connections you might not have consciously created, helping you discover relationships in your knowledge.

Syntax ¶

XLog supports multiple linking syntaxes:

Double Bracket Syntax (Recommended) ¶

1[Page Name](/Page_Name)
2[Subdirectory/Page Name](/Subdirectory/Page_Name)

This is the most common syntax, used by Obsidian, Roam Research, and other knowledge base tools.

Bare Page Names ¶

If you mention a page name in text without brackets, XLog’s autolink extension can convert it to a link:

1I wrote about this in Machine Learning Notes last week.

Configure this via the autolink pages extension.

Examples ¶

Personal Wiki ¶

1# Database Design Patterns
2
3Common patterns in [Relational Databases](/Relational_Databases):
4
5- [Normalization](/Normalization) - Reducing redundancy
6- [Indexing Strategies](/Indexing_Strategies) - Performance optimization
7- [Connection Pooling](/Connection_Pooling) - Resource management
8
9Related: [SQL Optimization](/SQL_Optimization), [NoSQL Databases](/NoSQL_Databases)

Each mentioned page automatically links, and those pages will show “Database Design Patterns” in their backlinks.

Research Notes ¶

 1# Paper: Attention Is All You Need (2017)
 2
 3Introduces the [Transformer Architecture](/Transformer_Architecture) for NLP tasks.
 4
 5Key innovation: [Self-Attention Mechanism](/Self-Attention_Mechanism) replaces recurrence.
 6
 7Builds on: [Sequence-to-Sequence Models](/Sequence-to-Sequence_Models)
 8Leads to: [BERT](/BERT), [GPT](/GPT), [T5](/T5)
 9
10Related concepts: [Attention Mechanisms](/Attention_Mechanisms), [Neural Machine Translation](/Neural_Machine_Translation)

This creates a research paper network showing how ideas connect across papers.

Learning Journal ¶

 1# 2026-05-07 - Learning Log
 2
 3Today I learned about [React Hooks](/React_Hooks).
 4
 5Connected to previous learning:
 6- [JavaScript Closures](/JavaScript_Closures) (hooks use closures internally)
 7- [Functional Programming](/Functional_Programming) (hooks encourage functional style)
 8- [Component Lifecycle](/Component_Lifecycle) (hooks replace lifecycle methods)
 9
10Questions for tomorrow: How do [Custom Hooks](/Custom_Hooks) work?

Over time, this builds a learning graph showing how concepts connect in your understanding.

Backlinks Display ¶

XLog shows backlinks at the bottom of each page:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Backlinks (3):
- Introduction to Machine Learning
- Deep Learning Fundamentals  
- AI Resources Collection
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Click any backlink to navigate to pages that reference the current page.

Comparison to Manual Linking ¶

Traditional Static Generators (Hugo, Jekyll) ¶

Manual linking:

1Check out [my other post](/posts/machine-learning/).

Problems:

• You must know the exact URL path
• Links are one-directional (target page doesn’t know you linked to it)
• Refactoring is painful (broken links everywhere)
• No knowledge graph emerges

XLog Automatic Backlinks ¶

Automatic linking:

1Check out [Machine Learning](/Machine_Learning).

Benefits:

• Just use the page name, XLog handles the rest
• Bidirectional (both pages know about the connection)
• Rename a page and all links update automatically
• Knowledge graph emerges organically

Use Cases ¶

1. Research and Literature Review ¶

Connect research papers, concepts, and citations:

1[Smith et al. 2020](/Smith_et_al._2020) builds on [Jones 2018](/Jones_2018) by adding [Attention Mechanisms](/Attention_Mechanisms).
2
3Contradicts findings in [Brown 2019](/Brown_2019).

Backlinks reveal which papers are most influential (most backlinks) and how ideas connect.

2. Zettelkasten Note-Taking ¶

Build a Zettelkasten-style knowledge base:

1# 202605071430 - Permanent Note on Spaced Repetition
2
3[Spaced Repetition](/Spaced_Repetition) improves long-term retention.
4
5Evidence: [Ebbinghaus Forgetting Curve](/Ebbinghaus_Forgetting_Curve)
6Tools: [Anki](/Anki), [SuperMemo](/SuperMemo)
7Related: [Active Recall](/Active_Recall), [Interleaving](/Interleaving)
8
9Source: [Book - Make It Stick](/Book_-_Make_It_Stick)

Each note links to related atomic ideas, building a knowledge network.

3. Personal Wiki Development ¶

Create an interconnected personal knowledge base:

1# Go Programming
2
3[Go](/Go) is a statically-typed language from [Google](/Google).
4
5Strengths: [Concurrency](/Concurrency) via [Goroutines](/Goroutines), simple syntax
6Weaknesses: [Generics](/Generics) (added in Go 1.18)
7
8Resources: [Effective Go](/Effective_Go), [Go by Example](/Go_by_Example)
9Projects: [XLog](/XLog), [Docker](/Docker), [Kubernetes](/Kubernetes)

Backlinks show what you’ve written about each topic across different contexts.

4. Project Documentation ¶

Connect documentation pages organically:

1# API Authentication
2
3Our API uses [OAuth 2.0](/OAuth_2.0) for authentication.
4
5Setup: See [API Setup Guide](/API_Setup_Guide)
6Security: Review [API Security Best Practices](/API_Security_Best_Practices)
7Troubleshooting: [Common API Errors](/Common_API_Errors)
8
9Related: [User Management](/User_Management), [Access Control](/Access_Control)

Developers can navigate documentation following their mental model, not a rigid hierarchy.

Benefits Over Manual Linking ¶

1. Lower Friction ¶

No need to remember exact paths or URLs. Just mention the page name.

2. Discover Connections ¶

Backlinks reveal unexpected relationships:

• “I didn’t realize I wrote about this in three different contexts”
• “These concepts are more related than I thought”

3. Refactoring Safety ¶

Rename a file? XLog updates all links automatically. No broken links to hunt down.

4. Knowledge Graph Emergence ¶

Over time, your backlinks reveal:

• Hubs - Pages with many backlinks are central concepts
• Clusters - Groups of highly interconnected pages
• Orphans - Pages with no backlinks might need connecting

This structure emerges naturally from your writing, not from artificial categorization.

Backlinks vs. Tags ¶

Both backlinks and hashtags organize knowledge, but differently:

Aspect	Backlinks	Hashtags
Relationship	Specific page-to-page	Topic categorization
Creation	Automatic when mentioning pages	Manual with tag
Hierarchy	Network (many-to-many)	Flat categories
Best for	Connecting specific ideas	Organizing by theme

Example:

1# Machine Learning Notes
2
3Learning about [Neural Networks](/Neural_Networks) and [Decision Trees](/Decision_Trees).
4
5Topics: #machine-learning #ai #python

• Backlinks connect to specific pages (Neural Networks, Decision Trees)
• Hashtags categorize broadly (machine-learning, ai)

Use both together for powerful organization.

Configuration ¶

Backlinks are provided by the “Autolink pages” extension (enabled by default).

To disable backlinks:

1xlog -disabled-extensions "autolink_pages"

(Not recommended - backlinks are core to XLog’s knowledge base experience)

Performance ¶

Backlinks are computed efficiently:

• Indexed on first page load
• Cached for subsequent requests
• Fast even with thousands of pages

For large knowledge bases (5000+ pages), backlink rendering is still sub-second.

Best Practices ¶

1. Link Liberally ¶

Don’t overthink it - link to any related concept. XLog handles the complexity.

2. Use Descriptive Page Names ¶

Instead of:

1[notes_20260507](/notes_20260507)

Use:

1[Neural Network Architectures - 2026-05-07](/Neural_Network_Architectures_-_2026-05-07)

Descriptive names make backlinks more useful.

3. Review Backlinks Regularly ¶

Check backlinks on your pages to:

• Discover forgotten connections
• Find pages that should link to each other
• Identify central concepts (many backlinks)

4. Create Index Pages ¶

Build index pages that link to many related concepts:

 1# Machine Learning Index
 2
 3Core Concepts:
 4- [Supervised Learning](/Supervised_Learning)
 5- [Unsupervised Learning](/Unsupervised_Learning)
 6- [Reinforcement Learning](/Reinforcement_Learning)
 7
 8Algorithms:
 9- [Linear Regression](/Linear_Regression)
10- [Neural Networks](/Neural_Networks)
11- [Decision Trees](/Decision_Trees)

These become hub pages with many backlinks.

Limitations ¶

1. No Partial Matches ¶

Links require exact page name matches. These won’t link:

1[Machine Learning](/Machine_Learning)  ← Links to "Machine Learning.md"
2Machine Learning      ← Won't auto-link (unless autolink extension configured)
3machine learning      ← Won't link (case-sensitive)

2. Cross-Directory Links Need Full Path ¶

1[Subdirectory/Page Name](/Subdirectory/Page_Name)  ← Required for pages in subdirectories
2[Page Name](/Page_Name)                ← Only finds pages in current directory

3. No Link Previews ¶

XLog shows backlinks but not link previews (hovering to see content). This is intentional - encourages clicking and exploring.

See Also ¶

• Hashtags - Complementary organization with tags
• Search - Find content across your knowledge base
• [Digital Gardening](digital gardening.md) - Philosophy behind backlinks
• [official extensions](official extensions.md) - Autolink pages extension details

Backlinks

See Also