docs

digital gardening
Edited: Saturday 9 May 2026

Digital Gardening with XLog

Digital gardening is a way of thinking about knowledge management that emphasizes organic growth, interconnection, and iterative refinement over polished publication.

What is Digital Gardening?

Unlike traditional blogging (which focuses on complete, polished posts in chronological order), digital gardening treats notes as living documents that:

  • Grow over time - Notes start small and expand as you learn more
  • Connect organically - Ideas link to each other, forming a knowledge graph
  • Stay incomplete - Rough notes are valuable; perfection isn’t required
  • Evolve continuously - Pages are updated and refined indefinitely

The result is a personal wiki - a non-hierarchical, interconnected collection of knowledge that represents how you actually think, not how you present yourself.

XLog’s Approach to Digital Gardening

XLog is specifically optimized for digital gardening and knowledge base building with features designed for this workflow:

The core of digital gardening is connection between ideas. XLog automatically converts page name mentions to links:

1When studying [Graph Theory](/Graph_Theory), I discovered connections to [Network Effects](/Network_Effects).

XLog creates:

  1. Clickable links to those pages
  2. Backlinks showing which pages reference each concept
  3. A knowledge graph revealing relationships

No manual link management required.

Hashtags for Organic Organization

Digital gardens resist strict hierarchies. Use hashtags for flexible categorization:

1# Neural Networks Research
2
3Notes on #machine-learning and #deep-learning architectures.
4
5Exploring #attention-mechanisms in transformers.

Pages can belong to multiple categories naturally, reflecting real knowledge organization.

Live Writing Workflow

Digital gardening emphasizes capturing thoughts quickly and refining later. XLog’s live preview supports this:

  1. Click “Edit” to open any page in your text editor
  2. Jot down rough notes in markdown
  3. Save and instantly see the rendered result
  4. Keep refining over time

No publish step, no build process during writing - just capture and connect.

Version Control with Git

Digital gardens evolve. XLog’s Git-native approach means:

  • Every change is versioned and recoverable
  • See how ideas developed over time
  • Experiment without fear of losing content
  • Sync across devices using standard Git workflows

Digital Gardens vs. Blogs

Aspect Digital Garden Traditional Blog
Content Rough, evolving notes Polished, finished posts
Organization Networked, interconnected Chronological, hierarchical
Updates Continuous refinement Published once, rarely updated
Structure Non-linear, wiki-like Linear, article-based
Audience Personal-first, public-optional Public-facing
Tone Work-in-progress, learning Authoritative, complete

XLog supports both, but excels at digital gardens.

XLog’s Niche: Knowledge Bases, Not General Websites

XLog is optimized for:

Personal wikis - Interconnected knowledge bases
Research notes - Academic and technical research
Digital gardens - Learning in public
Documentation - Technical docs and API references
Learning journals - Tracking knowledge growth

XLog is not optimized for:

Marketing websites - Use dedicated site builders
E-commerce - Requires specialized platforms
Photo portfolios - Use portfolio-specific tools
Multi-author publications - Needs real-time collaboration
Complex blogs - Dedicated blog platforms offer more themes/features

If you’re building an interconnected knowledge base with automatic backlinks and Git version control, XLog is perfect. If you need complex layouts, themes, or CMS features, use a general-purpose static site generator.

Examples of Digital Gardens Built with XLog

This documentation itself is a digital garden! Every page is interconnected, and concepts link naturally to each other. View the source at github.com/emad-elsaid/xlog.

Key characteristics you’ll notice:

  • Pages reference each other by name (automatically linked)
  • Ideas connect across different topics
  • Content grows and refines over time
  • Focus on knowledge organization, not presentation

Building Your Digital Garden

Start Small

Begin with a few notes about topics you’re learning:

1# Machine Learning
2
3I'm exploring #machine-learning concepts.
4
5Key areas: [Neural Networks](/Neural_Networks), [Decision Trees](/Decision_Trees), [Linear Regression](/Linear_Regression)
6
7## Resources
8- [Book recommendation]
9- [Course notes]

Mention other pages naturally in your writing. XLog converts them to links automatically. Don’t worry about creating the target page first - XLog creates empty pages for broken links.

Embrace Incompleteness

Rough notes are valuable. Publish work-in-progress. Mark pages as incomplete with:

1/warning 🚧 Work in Progress - Rough notes, needs expansion

Refine Over Time

Return to pages and add more:

  • Expand ideas as you learn
  • Add examples and clarifications
  • Connect to newly created pages
  • Update outdated information

Use Hashtags for Themes

Let themes emerge organically:

1#learning-in-public #zettelkasten #personal-knowledge-management

Click any hashtag to see all related pages.

Build a Knowledge Graph

As you write more, connections emerge:

  • Pages link to each other
  • Backlinks reveal relationships
  • Clusters of related concepts form
  • Your unique knowledge structure becomes visible

Philosophy: Filesystem as Garden

XLog’s Git-native approach means your garden is:

  • Portable - Just markdown files, readable anywhere
  • Future-proof - No proprietary formats or databases
  • Versionable - Full history of growth
  • Synchronizable - Use Git to sync across devices
  • Ownership - You control your data completely

Your digital garden grows in your filesystem, not someone else’s cloud.

Resources

Learn more about digital gardening:

See Also

Backlinks