Link Search Menu Expand Document


Below are some concepts that are helpful to know when using Dendron. Note that features with 🚧 are still under active development and might not be fully implemented.


Dendron supports markdown, a popular markup syntax that is like HTML but 1000x simpler. If you are new to markdown, you can read about the syntax here.


Frontmatter is a convenient way of adding extra information to your documents like a shorthand title or longer description (think any extra information you can use to describe a note). This type of information is generally called metadata and the structure used is called YAML. You can add it to the front of your markdown file and it won't show up in the preview. It was first introduced by jekyll.

You can read more about the frontmatter used in Dendron here


In Dendron, your workspace is the root of where all your files are located. It's set when you first run Dendron: Initialize Workspace. The folder that contains your workspace is also known as your workspace root.


Your workspace is made up of vaults. A dendron vault stores a collection of related notes. If you're familiar with git, it's just like a code repo. By default, Dendron creates a vaults folder when you first initialize a workspace. All your notes are stored on a per vault basis.

└── workspace
    ├── vault.main
    │   ├──
    │   ├──
    │   └──
    └── vault.secret (hypothetical)

By default, when you look for notes in Dendron, it will search over all vaults.

A vault can be one of two types:

  • local
  • remote

Local Vault

A local vault is what you start off with. Its a vault that is local to your file system.

Remote Vault

A remote vault is what you get when you run the Vault Add command and select a remote vault. This is a vault that is cloned from a git repo. It should be a similar format as what you see below

        fsPath: dendron
            type: git
            url: ''

Workspace Vault

When cloning a remote vault, you can either specify the remote git endpoint of a vault or a workspace. In the case of a workspace, all vaults from within the workspace will be imported separately. All these vaults are known as workspace vaults.


Within a vault, your notes are stored hierarchically as . delimited markdown files.

Below is a hypothetical hierarchy for a file tree:

└── project1/
    ├── project1/designs/
    │   └── project1/designs/promotion.png
    ├── project1/paperwork/
    │   └── project1/paperwork/
    └── project1/tasks/
        ├── project1/tasks/
        └── project1/tasks/

The same hierarchy in Dendron would look like the following:


You can read more about hierarchies here


A domain is the root of a hierarchy. In the example below, project1 would be the domain.



As you end up creating more notes, it can be hard to keep track of it all. This is why Dendron has schemas to help you manage your notes. Think of schemas as an optional type system for your information. They describe the hierarchy of your notes and are themselves, represented as a hierarchy.

You can create a schema by adding a YAML file with the following naming scheme {name}.schema.yml to your workspace.

Below is an example of a three-level hierarchy describing cli commands. You don't need to concern yourself with the details of the schema syntax just yet, just know that this schema will match the following glob patterns: cli.*, cli.*.cmd, cli.*.cmd.*, cli.*.env

- id: cli
  desc: command line interface reference
  parent: root
  namespace: true
    - cmd
    - env
- id: env
  desc: variables relevant for command
- id: cmd
  desc: subcommands 
  namespace: true


Stubs are notes that don't exist but that you might want to create. They will show up as suggestions in lookup results. There are two reasons why these suggested notes might show up:

  • they are the uncreated parent of a note deeper in the hierarchy (eg. might be a stub for
  • they are possible notes according to the schema

The + sign next to the suggestion indicates that the note is a stub and does not exist


Pods are the mechanisms Dendron uses to import and export notes. Dendron has a different pod depending on where you are getting and publishing your data to.

Command Bar

The command bar is native to vscode. You can use it to run dendron commands, which will all be prefixed with Dendron:. You can use the following shortcut to open the command bar.

Lookup Bar

The lookup bar is how you interact with notes inside of Dendron. Use it to create, find, and delete notes. You can type > Dendron: Lookup in the Command Bar or use the Ctrl+L shortcut.


Kebab Case

Kebab case is when you replace spaces with dashes and upper case with lower case.

  • Example
    • Hello World -> hello-world