<h1 id="web">Web<a aria-hidden="true" class="anchor-heading icon-link" href="#web"></a></h1>
<h2 id="summary">Summary<a aria-hidden="true" class="anchor-heading icon-link" href="#summary"></a></h2>
<p>Dendron now is available in <a href="https://code.visualstudio.com/api/extension-guides/web-extensions">VSCode on the Web</a> for a subset of features.</p>
<p>The easiest way to try out Dendron on the web is to navigate to your Dendron repository in Github, and press <code>'.'</code> - this will launch github.dev (which is a Github hosted instance of VSCode on the web). You can then install Dendron through the extensions tab just like you would in desktop VS Code and you should be good to go!</p>
<p>This makes it very easy to share your notes with someone without needing them to download VS Code themselves. They can also contribute to your notes from within the browser!</p>
<p><em>Note, this is a <a class="color-tag" style="--tag-color: #a90308;" href="/notes/J6CKDqxWwcpve4CrpF5aa">#stage.germ</a> feature. The supported commands and features may have limited functionality.</em></p>
<h2 id="features">Features<a aria-hidden="true" class="anchor-heading icon-link" href="#features"></a></h2>
<blockquote>
<p>NOTE: Dendron on the web is limited to just a few features right now, but we are working on bringing more of the full Dendron capabilities to the web:</p>
</blockquote>
<h3 id="copy-note-url">Copy Note URL<a aria-hidden="true" class="anchor-heading icon-link" href="#copy-note-url"></a></h3>
<p></p><p></p><div class="portal-container">
<div class="portal-head">
<div class="portal-backlink">
<div class="portal-title">From <span class="portal-text-title">Commands</span></div>
<a href="/notes/eea2b078-1acc-4071-a14e-18299fc28f47" class="portal-arrow">Go to text <span class="right-arrow">→</span></a>
</div>
</div>
<div id="portal-parent-anchor" class="portal-parent" markdown="1">
<div class="portal-parent-fader-top"></div>
<div class="portal-parent-fader-bottom"></div><h3 id="copy-note-url-1">Copy Note URL<a aria-hidden="true" class="anchor-heading icon-link" href="#copy-note-url-1"></a></h3>
<ul>
<li>shortcuts:
<ul>
<li>mac: <code>cmd+shift+u</code></li>
<li>windows: <code>ctrl+shift+u</code></li>
</ul>
</li>
</ul>
<p>Get URL of current note from published site</p>
<p>If you highlight a header, will copy the url with the header set as the anchor</p>
<p>The url is taken from the <a href="/notes/f2ed8639-a604-4a9d-b76c-41e205fb8713#siteurl">siteUrl</a> property.</p>
<p><img src="https://foundation-prod-assetspublic53c57cce-8cpvgjldwysl.s3-us-west-2.amazonaws.com/assets/images/notes.copy-url.gif"></p>
</div></div><p></p><p></p>
<h3 id="lookup">Lookup<a aria-hidden="true" class="anchor-heading icon-link" href="#lookup"></a></h3>
<p>Lookup can be used to find and create notes. There are a few limitations compared with the desktop version:</p>
<ul>
<li><a href="/notes/ad270a7d-2aed-4273-8319-eb6536e38b29">Modifiers</a> are not supported, and a default value is used instead.</li>
<li>Schema information is not available in the lookup results, and notes created will not have schema templates applied.</li>
</ul>
<h3 id="tree-view">Tree View<a aria-hidden="true" class="anchor-heading icon-link" href="#tree-view"></a></h3>
<p></p><p></p><div class="portal-container">
<div class="portal-head">
<div class="portal-backlink">
<div class="portal-title">From <span class="portal-text-title">Tree View</span></div>
<a href="/notes/hur7r6gr3kqa56s2vme986j" class="portal-arrow">Go to text <span class="right-arrow">→</span></a>
</div>
</div>
<div id="portal-parent-anchor" class="portal-parent" markdown="1">
<div class="portal-parent-fader-top"></div>
<div class="portal-parent-fader-bottom"></div><h2 id="summary-1">Summary<a aria-hidden="true" class="anchor-heading icon-link" href="#summary-1"></a></h2>
<p>The Tree View shows you the hierarchy of your notes</p>
<p><img src="https://foundation-prod-assetspublic53c57cce-8cpvgjldwysl.s3-us-west-2.amazonaws.com/assets/images/workbench.treeview.gif" alt="Dendron Tree View"></p>
<h2 id="features-1">Features<a aria-hidden="true" class="anchor-heading icon-link" href="#features-1"></a></h2>
<h3 id="hierarchal-view-of-all-your-notes">Hierarchal view of all your notes<a aria-hidden="true" class="anchor-heading icon-link" href="#hierarchal-view-of-all-your-notes"></a></h3>
<p>Get a top down view of all your notes</p>
<h3 id="access-frequently-used-commands-using-the-menu">Access frequently used commands using the menu<a aria-hidden="true" class="anchor-heading icon-link" href="#access-frequently-used-commands-using-the-menu"></a></h3>
<p>Use the context menu to quickly create, and change the tree view appearance</p>
<h2 id="getting-started">Getting started<a aria-hidden="true" class="anchor-heading icon-link" href="#getting-started"></a></h2>
<h3 id="focusing-the-tree-view">Focusing the tree view<a aria-hidden="true" class="anchor-heading icon-link" href="#focusing-the-tree-view"></a></h3>
<p>If the tree view isn't currently in focus, type <code>CTRL+SHIFT+P</code>/<code>CMD+SHIFT+P</code> to open the command prompt and type in <a href="/command:dendron.treeView.focus"><code>Dendron: focus on tree view</code></a> to make it appear</p>
<h3 id="create-a-new-note">Create a new note<a aria-hidden="true" class="anchor-heading icon-link" href="#create-a-new-note"></a></h3>
<p>Click the create new context button to create a new note</p>
<div style="position: relative; padding-bottom: 56.25%; height: 0;"><iframe src="https://www.loom.com/embed/5975b56f2dfb4e0d9615e9a507f2f56e" frameborder="0" webkitallowfullscreen="" mozallowfullscreen="" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>
<h3 id="show-a-note-by-filename-or-title">Show a note by filename or title<a aria-hidden="true" class="anchor-heading icon-link" href="#show-a-note-by-filename-or-title"></a></h3>
<p>Click on the three dots in the tree view to change the tree view display</p>
<h3 id="right-click-to-delete-delete">Right click to Delete Delete<a aria-hidden="true" class="anchor-heading icon-link" href="#right-click-to-delete-delete"></a></h3>
<p>Open context menu in tree view by right-click and select <code>Dendron: Delete</code></p>
<div style="position: relative; padding-bottom: 53.75%; height: 0;"><iframe src="https://www.loom.com/embed/93454b54acc94ea5be43ca070f52d07c" frameborder="0" webkitallowfullscreen="" mozallowfullscreen="" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>
</div></div><p></p><p></p>
<blockquote>
<p>NOTE: Copy URL of the selected header set as the anchor is not supported yet</p>
</blockquote>
<h3 id="preview">Preview<a aria-hidden="true" class="anchor-heading icon-link" href="#preview"></a></h3>
<p></p><p></p><div class="portal-container">
<div class="portal-head">
<div class="portal-backlink">
<div class="portal-title">From <span class="portal-text-title">Preview</span></div>
<a href="/notes/Lnp1URddmWEWweyf" class="portal-arrow">Go to text <span class="right-arrow">→</span></a>
</div>
</div>
<div id="portal-parent-anchor" class="portal-parent" markdown="1">
<div class="portal-parent-fader-top"></div>
<div class="portal-parent-fader-bottom"></div><h2 id="summary-2">Summary<a aria-hidden="true" class="anchor-heading icon-link" href="#summary-2"></a></h2>
<p>The Dendron Preview gives you a rich HTML preview for your notes. </p>
</div></div><p></p><p></p>
<blockquote>
<p>NOTE: some capabilities like note references are currently not supported</p>
</blockquote>
<h2 id="quickstart">Quickstart<a aria-hidden="true" class="anchor-heading icon-link" href="#quickstart"></a></h2>
<ol>
<li>Open a Dendron repository in Github, such as <code>https://github.com/dendronhq/dendron-site</code>.</li>
<li>Press the <code>.</code> button on your keyboard while you have the Github page open in your browser. This will launch you to <code>https://github.dev/dendronhq/dendron-site</code></li>
<li>Install Dendron for your browser VS Code if you haven't done so before. </li>
<li>After Dendron finishes installing, try running lookup. Keyboard shortcuts will still work in the browser.</li>
</ol>
<div style="position: relative; padding-bottom: 64.5933014354067%; height: 0;"><iframe src="https://www.loom.com/embed/c8e00408f4314174b3014879f243c9f4" frameborder="0" webkitallowfullscreen="" mozallowfullscreen="" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>
<hr>
<strong>Backlinks</strong>
<ul>
<li><a href="/notes/9bc92432-a24c-492b-b831-4d5378c1692b">Changelog</a></li>
<li><a href="/notes/eojyowzxe8ufiqoi9jf5830">0.109</a></li>
<li><a href="/notes/2fbbket7taz53ocm9o1s7ht">0.110</a></li>
<li><a href="/notes/4li0gn572gw4q4jaqtca0pm">0.112</a></li>
<li><a href="/notes/Lnp1URddmWEWweyf">Preview</a></li>
</ul>

dendron.dendron-site


[![dendronhq on Twitter](https://img.shields.io/twitter/follow/dendronhq?style=social)](https://link.dendron.so/twitter)
[![Dendron on YouTube](https://img.shields.io/youtube/channel/subscribers/UC8GQLj4KZhN8WcJPiKXtcRQ?style=social)](https://link.dendron.so/youtube)
[![Discord](https://img.shields.io/discord/717965437182410783?color=blueviolet&label=Discord&style=flat-square)](https://link.dendron.so/discord)

[![VS Code Installs](https://img.shields.io/visual-studio-marketplace/i/dendron.dendron?label=VS%20Code%20Installs&color=blue&style=flat-square)](https://link.dendron.so/vscode)
[![VSCodium Installs of Dendron](https://img.shields.io/open-vsx/dt/dendron/dendron?label=VSCodium%20Installs&style=flat-square)](https://open-vsx.org/extension/dendron/dendron)


![Dendron Logo](https://foundation-prod-assetspublic53c57cce-8cpvgjldwysl.s3-us-west-2.amazonaws.com/assets/logo-256.png)

Dendron is an **open-source, local-first, markdown-based, note-taking tool**. 
Think of it as a **cache for everything that you care about** - if you've spent **more then five minutes** solving a problem, you should **never** spent any more time solving the same exact problem. 

Dendron is a knowledge base built by and for developers and integrates natively with IDEs like [VS Code](https://code.visualstudio.com/) and [VSCodium](https://vscodium.com/).


## Motivation

> "We are overwhelmed with information and we don't have the tools to properly index and filter through it. [The development of these tools, which] will give society access to and command over the inherited knowledge of the ages [should] be the first objective of our scientist" - Vannevar Bush, 1945

## How

Dendron builds on top of the past five decades of programming languages and developer tooling. We apply the key lessons from software to the management of general knowledge. 
We make managing general knowledge like managing code and your PKM like an IDE.

## Design Principles

### Developer Centric

Dendron aims to create a world class developer experience for managing knowledge.

Our goal is to provide a tool with the efficiency of Vim, the extensibility of Emacs, and the approachability of VS Code.

What this means:

- dendron features are text centric and composables
- dendron provides the lowest friction interface for working with your knowledge base
- dendron optimizes for efficiency, speed, and keyboard focused ux
- dendron comes with sane defaults and the ability to customize to your liking
- dendron can be extended along any dimension

### Gradual Structure

Dendron extends markdown with structural primitives to make it easier to manage at scale and tooling on top to work with this structure.

Different knowledge bases require different levels of structure - a PKM used for keeping daily journals is different than a company wide knowledge base used by thousands of developers.

Dendron works with any level of structure, meaning you can take free form notes when starting out and gradually layer on more structure as your knowledge base grows more.

### Flexible and Consistent

Dendron is both flexible and consistent. It provides a consistent structure for all your notes and gives you the flexibility to change that structure.

In Dendron, you can refactor notes and Dendron will make sure that your PKM is consistent throughout. This means that you have the best of both worlds: a basic structure for the organization but the flexibility to change it.

## Features

Dendron has hundreds of features. The following is a list of highlights.

### It's just Plaintext

- manage using git
- use git blame to see individual edits
- edit in anything that works on text files (eg. Vim)

<a href="https://www.loom.com/share/67b90027de974702a78753158822e96b">
    <img style="" src="https://org-dendron-public-assets.s3.amazonaws.com/images/67b90027de974702a78753158822e96b.gif">
</a>

### Markdown and More

- create diagrams using mermaid
- write math using katex
- embed notes (and parts of notes) in multiple places using note references

<a href="https://www.loom.com/share/f7e710a3c3454e75a2938d2cbed359d9">
    <img style="" src="https://org-dendron-public-assets.s3.amazonaws.com/images/f7e710a3c3454e75a2938d2cbed359d9.gif">
</a>

### Lookup

- one unified way to find and create notes
- quickly traverse and create new hierarchies

<a href="https://www.loom.com/share/29ec0fe0964648feae08387a7bb8c45f">
    <img style="" src="https://org-dendron-public-assets.s3.amazonaws.com/images/29ec0fe0964648feae08387a7bb8c45f.gif">
</a>

### Schema

- ensure consistency for your knowledge base
- get autocomplete hints when creating new notes
- automatically apply common templates to notes on creation

<a href="https://www.loom.com/share/faee68959647441e86b9c4c183384ce5">
    <img style="" src="https://org-dendron-public-assets.s3.amazonaws.com/images/faee68959647441e86b9c4c183384ce5.gif">
</a>

### Navigation

- explore relationships using backlinks
- navigate to notes, headers and arbitrary blocks
- visualize your knowledge base using the graph view

<a href="https://www.loom.com/share/2d365d965c104af2a1501d789aa2d2b1">
    <img style="" src="https://org-dendron-public-assets.s3.amazonaws.com/images/2d365d965c104af2a1501d789aa2d2b1.gif">
  </a>

### Refactor

- restructure your knowledge base without breaking links
- rename a single note or refactor using arbitrary regex
- rename and move individual sections within notes

<a href="https://www.loom.com/share/b1a84decc53f4639b5bc60c885c56543">
    <img style="" src="https://org-dendron-public-assets.s3.amazonaws.com/images/b1a84decc53f4639b5bc60c885c56543.gif">
</a>

### Vaults

- mix and match knowledge using vaults, a git backed folder for your notes
- use vaults to separate concerns, like personal notes and work notes
- publish vaults on git to collaborate and share knowledge with others

<a href="https://www.loom.com/share/c51e457ac2b0415ca91a8929411add64">
    <img style="" src="https://org-dendron-public-assets.s3.amazonaws.com/images/c51e457ac2b0415ca91a8929411add64.gif">
  </a>

### Publish

- export your knowledge base as a static (nextjs) site
- lookup locally and share globally with generated links
- manage what you publish using fine grained permissions on a per vault, per hiearchy and per note basis

<a href="https://www.loom.com/share/727537e0fd49481cac2accc2b3362fa3">
    <img style="" src="https://org-dendron-public-assets.s3.amazonaws.com/images/727537e0fd49481cac2accc2b3362fa3.gif">
  </a>

## Use Cases

- personal knowledge management (PKM)
- documentation
- meeting notes
- tasks and todos
- blogging
- customer relationship management

## Getting Started

Interested in trying out Dendron? Jump right in with the [Getting Started Guide](https://wiki.dendron.so/notes/678c77d9-ef2c-4537-97b5-64556d6337f1/)!

## Join Us

Dendron wouldn't be what it is today without our wonderful set of members and supporters.

### Community Calendar

We have a bunch of community events that we host throughout the week. You can stay up to date on whats happening by taking a look at our community calendar!

- View and register for upcoming [Dendron Community Events on Luma](https://link.dendron.so/luma)

### Dendron Newsletter

- [Subscribe to the Dendron Newsletter](https://link.dendron.so/newsletter)

Dendron sends out a weekly newsletter highlighting:

- Latest release features
- Latest [Dendron blog](https://blog.dendron.so) posts
- Insights from the [Dendron Discord](https://link.dendron.so/discord) community
- RFC updates and [GitHub discussions](https://link.dendron.so/6WvK)
- and more!

### Join other Dendrologists

There are a variety of ways to connect with Dendron devs, contributors, and other members of the Dendron community:

- Join the [Dendron on Discord](https://link.dendron.so/discord) 
- Follow [Dendron on Twitter (`@dendronhq`)](https://link.dendron.so/twitter)
- Checkout [Dendron on GitHub](https://link.dendron.so/github)
- Read the [Dendron Blog](https://blog.dendron.so/)
- Subscribe to the [Dendron Newsletter](https://link.dendron.so/newsletter)

## Contributors ✨

Dendron wouldn't be what it is today without help from the wonderful gardeners 👨‍🌾👩‍🌾

If you would like to contribute (docs, code, finance, or advocacy), you can find instructions to do so [here](https://wiki.dendron.so/notes/125c990b-6fe7-4ada-a65f-44cbde8b33f0.html).
See [here](https://github.com/dendronhq/dendron#contributors-) for the list of existing contributors.

## License

Dendron is distributed under the GNU AFFERO GENERAL PUBLIC LICENSE Version 3.

See [LICENSE](https://github.com/dendronhq/dendron/blob/master/LICENSE.md) and [NOTICE](https://github.com/dendronhq/dendron/blob/master/NOTICE.md) for more information.

> The above license information is in regard to the Dendron software project in the `dendronhq/dendron` repository. When it comes to this repository, the `dendronhq/dendron-site` repository of documentation, this is released under the [MIT License](https://github.com/dendronhq/dendron-site/blob/master/LICENSE.md)