Tutorial
Welcome to Dendron! Dendron is a developer-focused knowledge base that helps you manage information using flexible hierarchies!
You are currently in the tutorial vault (a vault is the folder where your notes are stored). Feel free to edit this note and create new files as you go through the quickstart!
Create a Note
- Use
Ctrl+L
/Cmd+L
to bring up the lookup prompt - Type
dendron
and selectCreate New
-
NOTE: After you press enter, Dendron will create and open the
dendron
note. Use<CTRL>-<TAB>
to come back to this note
You just created your first note!
-
NOTE: Notes in Dendron are just plain text markdown with some frontmatter on the top. You can edit them in Dendron or using
vimyour favourite text editor.
Find a Note
- Use
Ctrl+L
/Cmd+L
to bring up the lookup prompt again - Type
dendron
and press<ENTER>
-
TIP: you don't have to type out the entire query, press
<TAB>
to autocomplete
You just looked up
a note!
-
NOTE: in Dendron, you can find or create notes using the lookup prompt
Organize your Notes
- Bring up the lookup prompt again
- Type
tutorial.one
You just created your first hierarchy!
-
NOTE: hierarchies in Dendron are just
.
delimited files. This makes each note both a file and a folder and makes it easy to keep your notes organized -
TIP: You can use the Dendron Tree View to view your hierarchy. If it's not currently in focus, you can use
CTRL+SHIFT+P
/CMD+SHIFT+P
to open the command prompt and type inDendron: focus on tree view
to make it appear
Create a link
- In the current note, type
[[
- this should trigger the autocomplete. You can typeone
to narrow it down to the note you just created and hit enter
You just created your first link!
-
NOTE: the links with the
[[
are called wikilinks (because they were first popularized by Wikipedia) -
TIP: If you hover your mouse over the link, you can get a preview of the contents inside the note!
Navigate a link
- Move your text cursor over the link you just created. Hold down
<CTRL>+<ENTER>
/<CMD>+<ENTER>
-
TIP: You can also use
CTRL+CLICK
orCMD+CLICK
to navigate links via mouse
You just navigated the link!
Refactor a Note
- Open tutorial.one (Private), bring up the command prompt (
CTRL+SHIFT+P
/CMD+SHIFT+P
) and typeDendron: Rename Note
- Replace
tutorial
withmy-note
and then press<ENTER>
- You just refactored the note!
-
NOTE: when you rename a note, Dendron updates all links and references of the original note being renamed. Try switching back to Tutorial to see the updated link!
-
TIP: in addition to renaming one note at a time, dendron has an entire collection of refactoring commands that let you change headers, move around sections, and refactor entire hierarchies!
Conclusion
Congrats, you finished the Dendron tutorial!
Was there anything unclear or buggy about this tutorial? Please report it so we can make it better!
Next Steps
Depending on your needs, here are some common next steps:
-
I want to start writing: Create a daily journal note (docs)
-
I want to use templates: Use the Appy Template command to apply templates to existing notes
-
I want to do a longer tutorial: Check out our 5min tutorial to explore more of Dendron's functionality
-
I want to implement a particular workflow (bullet journal, zettelkasten, etc): Check out community workflow guides
-
I want to use Dendron for tasks and todos: See the Getting Things Done (GTD), Bullet Journaling, and Other Task Management Workflows for how the founder of Dendron uses it to manage his work.
-
I want to explore advanced features: See next steps for longer walkthroughs and advanced functionality!
-
I want to start clean with a new vault at a custom location: Run Dendron: Initialize Workspace from the command prompt (or click this link) to start from a clean slate
-
I want to use Dendron as a knowledge base for my team: Read the Dendron team setup to get started
Coming from Obsidian? Click here to import your Obsidian notes (or any markdown notes) into Dendron to see how they look.
Community
Dendron is more that just a tool - we are also a community of individuals that are passionate about knowledge management. If you need help or want to connect with the community, join us in the Discords.
You can also:
- Star us on GitHub
- Follow us on Twitter
- Subscribe to the Dendron Newsletter
Backlinks