Troubleshooting

General

90% of all issues can be solved with one of the following steps:

1. Reload your window. This is the equivalent of restarting your computer.
   • > Developer: Reload Window
2. Check that all the recommended extensions are installed.
   • Make sure you have the necessary extensions by checking searching for @enabled dendron inside the extensions pane and making sure that you have the latest version of all dendron extensions.

Schemas

I’m getting a you cannot define a mapping item when in a sequence when trying to define a schema

That means there’s an issue with your yaml. You can paste it in yaml lint to check that you are using the correct yaml syntax.

Markdown Preview

Why can’t I click the checkbox?

It could be that you are using the VSCode default markdown instead of Dendron’s Markdown Preview.

They both have identical icons and its currently not possible to disable the builtin preview (we are looking into fixing this here).

Meanwhile, you can open Dendron’s markdown preview by clicking the preview button on the left of the menu bar or by using the > Markdown Preview Enhanced: Open Preview to the Side command

Misc

Why does Dendron create root.* files in my vault?

• Dendron currently creates a root.md file and a root.schema.yml file where you initialize your vault. these files will be used in the future to automatically generate an index of everything in your vault. you may safely ignore them for now

What is the extra text that is created at the beginning of each note?

• currently, you might see the following text added to the top of your note. This is additional metadata that Dendron uses to manage your files.

---
id: 4407f75d-7334-47a5-9f19-18b458618136
title: dendron.lookup.hello
desc: ''
updated: 1594078624566
created: 1594078624566
data: {}
custom: {}
fname: dendron.lookup.hello
parent: null
children: []
---

Why are there two book icons that do markdown preview?

We use an extension to do markdown preview. VSCode comes with its default markdown preview extension and its not currently possible to hide the button. You can re-open and upvote the issue here if you want to fix this.

How are hierarchies created?

Hierarchies today are created automatically when dendron crawls your folder for . delimited file names and custom schema.yml files.