Dendron — Hierarchical Note-Taking for Developers in VS Code

Introduction

Dendron is a free, open-source knowledge management tool that runs inside VS Code. It takes a unique approach by combining hierarchical file naming (dot-separated paths like dev.python.testing) with the flexibility of wikilinks and backlinks. This structure lets you organize thousands of notes without losing the ability to discover connections. Dendron is designed for developers who need to manage large, evolving knowledge bases.

What Dendron Does

• Organizes notes using hierarchical dot-separated naming conventions (e.g., lang.python.async)
• Provides fast fuzzy lookup to navigate large note collections by hierarchy path
• Supports note refactoring: rename, move, and restructure hierarchies without breaking links
• Defines schemas that enforce structure and provide templates for new notes in a hierarchy
• Publishes notes as a static site using Next.js with full-text search

Architecture Overview

Dendron is implemented as a VS Code extension in TypeScript with a separate engine process that manages the note index. The engine parses all Markdown files in the workspace, builds a hierarchical tree based on filename conventions, and maintains a graph of wikilinks and backlinks. Lookup queries are processed against this in-memory index for sub-millisecond results. The publishing pipeline transforms Markdown notes into a Next.js application with server-side rendering.

Self-Hosting & Configuration

• Install the Dendron extension from the VS Code marketplace
• Initialize a workspace through the command palette, which creates the folder structure and config
• Configure vaults (note directories) in dendron.yml to organize notes across multiple repositories
• Schemas are defined in YAML files that specify hierarchy patterns, templates, and required fields
• Publish notes with the built-in CLI: npx dendron publish init and npx dendron publish export

Key Features

• Hierarchy-first organization scales to tens of thousands of notes without losing navigability
• Lookup bar searches by hierarchy path with fuzzy matching, faster than full-text search for structured notes
• Note refactoring updates all references when you rename or move notes across hierarchies
• Multi-vault support lets you combine personal notes, team wikis, and reference vaults in one workspace
• Schema-enforced templates ensure consistency across notes in the same hierarchy

Comparison with Similar Tools

• Foam — Also VS Code-based but free-form with wikilinks; Dendron adds hierarchical structure and schema enforcement
• Obsidian — Standalone app with a rich plugin ecosystem and graph view; Dendron runs inside VS Code and emphasizes hierarchy over freeform linking
• Logseq — Outliner-based with daily journals; Dendron uses file-based notes with dot-separated naming
• Roam Research — Pioneered bidirectional linking but is proprietary and cloud-only; Dendron is free, local-first, and open source
• Notion — All-in-one workspace with databases; Dendron stores everything in plain Markdown files with no lock-in

FAQ

Q: Is Dendron still maintained? A: The core project moved to community maintenance after the original team shifted focus. The extension remains functional and community contributions continue.

Q: Can I use Dendron with existing Markdown notes? A: Yes. You can point a Dendron vault at any folder of Markdown files. Hierarchical naming is encouraged but not required.

Q: What does the hierarchy naming convention look like? A: Notes are named with dot-separated paths: project.backend.auth.oauth creates a four-level hierarchy. Each segment can be navigated independently in the lookup bar.

Q: Can I publish my Dendron notes as a website? A: Yes. Dendron includes a publishing pipeline that generates a Next.js static site with search, navigation, and backlink display.

Sources

• https://github.com/dendronhq/dendron
• https://wiki.dendron.so/