Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dendronhq/dendron

The personal knowledge management (PKM) tool that grows as you do!
https://github.com/dendronhq/dendron

dendron markdown markdown-editor pkm vscode zettelkasten

Last synced: 7 days ago
JSON representation

The personal knowledge management (PKM) tool that grows as you do!

Host: GitHub
URL: https://github.com/dendronhq/dendron
Owner: dendronhq
License: apache-2.0
Created: 2020-06-24T17:06:00.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2024-04-17T17:17:36.000Z (7 months ago)
Last Synced: 2024-10-28T21:02:52.972Z (7 days ago)
Topics: dendron, markdown, markdown-editor, pkm, vscode, zettelkasten
Language: TypeScript
Homepage: https://wiki.dendron.so
Size: 109 MB
Stars: 6,725
Watchers: 56
Forks: 255
Open Issues: 790
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md

Awesome Lists containing this project

stars - dendronhq/dendron
awesome-starred-test - dendronhq/dendron - The personal knowledge management (PKM) tool that grows as you do! (TypeScript)
awesome-github-repos - dendronhq/dendron - The personal knowledge management (PKM) tool that grows as you do! (TypeScript)
awesome-repositories - dendronhq/dendron - The personal knowledge management (PKM) tool that grows as you do! (TypeScript)
awesome-note-taking - Dendron - VSCode plugin that uses hierarchical note structure. (Open Source / Editor Plugin)
awesome-zettelkasten - Dendron
awesome-starred - dendronhq/dendron - The personal knowledge management (PKM) tool that grows as you do! (markdown)
awesome - dendronhq/dendron - The personal knowledge management (PKM) tool that grows as you do! (TypeScript)
Awesome-desktop-notes - Dendron - Local-first, markdown based, hierarchical built on top of VSCode and friends. ([↑](#-contents) Free)
project-awesome - dendronhq/dendron - The personal knowledge management (PKM) tool that grows as you do! (TypeScript)
jimsghstars - dendronhq/dendron - The personal knowledge management (PKM) tool that grows as you do! (TypeScript)

README

        [![StandWithUkraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://github.com/vshymanskyy/StandWithUkraine/blob/main/docs/README.md)

[![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 of Dendron](https://img.shields.io/visual-studio-marketplace/i/dendron.dendron?label=VS%20Code%20Installs%20of%20Dendron&color=blue&style=flat-square)](https://link.dendron.so/vscode)

[![All Contributors](https://img.shields.io/badge/all_contributors-244-orange.svg?style=flat-square)](#contributors-)

# 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**. It's a personal knowledge management solution (PKM) built specifically 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

## Why

Most PKM tools help you create notes but slam into a wall retrieving them once your knowledge base reaches a certain size threshold. That threshold varies with the tool, but virtually everything stops working past 10k notes unless the user was extremely diligent about organizing their knowledge. Past this threshold, entropy wins and every query becomes a keyword search and scrolling through pages of results.

> Dendron's mission is to help **humans organize, find, and work with any amount of knowledge**.

It not only helps you create notes but also retrieve them - retrieval works as well with ten notes as it does with ten thousand.

## 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)



    



### Markdown and More

- create diagrams using mermaid

- write math using katex

- embed notes (and parts of notes) in multiple places using note references



    



### Lookup

- one unified way to find and create notes

- quickly traverse and create new hierarchies



    



### Schema

- ensure consistency for your knowledge base

- get autocomplete hints when creating new notes

- automatically apply common templates to notes on creation



    



### Navigation

- explore relationships using backlinks

- navigate to notes, headers and arbitrary blocks

- visualize your knowledge base using the graph view



    

  

### Refactor

- restructure your knowledge base without breaking links

- rename a single note or refactor using arbitrary regex

- rename and move individual sections within notes



    



### 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



    

  

### 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 hierarchy and per note basis



    

  

## 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). For setup of local development environment run `./setup.sh` which automates the setup.

  

    

      
_lsernau
🐛 💵

      
_{Kaan Genç}
📖 💻

      
_{Mandar Vaze}
📖

      
_hfellerhoff
📖

      
_Fayçal
📖 🐛

      
_Ronald
🐛 💵

      
_{Simon-Claudius}
🐛

    

    

      
_{Scott Spence}
🐛

      
_{Zhang Handuo}
🐛

      
_{Cameron Yick}
📝 📖 💻

      
_{Bryan Jenks}
📖 🐛

      
_{Simon J S Liu}
🐛

      
_b0xian
🐛

      
_Orcomp
🐛 📖

    

    

      
_{Shekhar Neupane}
📖

      
_{John Meyer}
🐛

      
_{John Young}
🐛

      
_{Max Krieger}
📖 📝 🐛

      
_{Alan Ionita}
📖

      
_Aditya
🐛

      
_{Gijs-Jan Roelofs}
🐛

    

    

      
_{Vivek Raja}
🐛

      
_{Kevin Poorman}
🐛

      
_{Lars Solberg}
🐛

      
_8brandon
💻

      
_{Aleksey Rowan}
💻 📖 🐛

      
_{Paul Wright}
📖

      
_{Jeff Barr}
📖

    

    

      
_{Stephen Krider}
📖

      
_{Nikita Voloboev}
💻

      
_{Jason Jones}
📖

      
_{Mark Hyunik Choi}
💻 🐛 🧑‍🏫 📖 📝

      
_{Peter Arwanitis}
🐛

      
_flammehawk
📖 💵 💻

      
_{Kevin Lin}
💻 🧑‍🏫 📖 📝 🐛

    

    

      
_{Kiran Pathakota}
💻 🧑‍🏫 📖 📝 🐛

      
_jn64
🐛

      
_Thelusion
🐛

      
_{Víctor Reyes Rodríguez}
🐛

      
_funnym0nk3y
🐛

      
_sidwellr
🐛

      
_{Darren Brierton}
🐛

    

    

      
_timDeHof
🐛

      
_singlebungle
🐛

      
_{elliotfielstein}
🐛

      
_{jonathanyeung}
💻

      
_SR--
📖 🐛 💻

      
_{Denis Sikuler}
📖

      
_{Mat Chavez}
🐛

    

    

      
_micharris42
🐛 📖

      
_teauxfu
📖

      
_andrey-jef
📖 🐛

      
_{Samuel Hobl}
💻 📖 🔧

      
_apastuszak
🐛 📖

      
_{Felipe Whitaker}
📖

      
_unamusedmon
🐛

    

    

      
_{Do Soon Kim}
🐛

      
_{Daria Vasyukova}
🐛

      
_{Dave Richardson}
🐛 📖

      
_Ding
📖 🐛

      
_John
🐛

      
_{Jeff Hopper}
🐛

      
_{Ryan Randall}
🐛 📖

    

    

      
_CyberFoxar
🐛

      
_{Britt Selvitelle}
🐛 💵 📖 💻

      
_lenamio
📖

      
_{Sai Santosh}
💻

      
_viz
💻 📖

      
_Jminding
📖

      
_{Lukas Orsvärn}
🐛

    

    

      
_sotn3m
🐛

      
_{Matias Forbord}
📖

      
_{Kyle Tycholiz}
🐛 📖

      
_Stedag
💻

      
_{Miguel Pereira}
📖 🐛

      
_{Laurențiu Nicola}
🐛 📖

      
_{Eric Marthinsen}
🐛

    

    

      
_{Jonathan Dorety}
📖

      
_{Buck DeFore}
📖

      
_{Ikko Ashimine}
📖 ⚠️

      
_simkimsia
🐛 💵 ✅ 📖 💡

      
_demorganslaw
🐛

      
_guilhermesfc
🐛

      
_{Idan Gazit}
🐛

    

    

      
_ragamroll
🐛

      
_{Denis Novikov}
🐛 🖋

      
_Mo
🐛

      
_{Claus Conrad}
🐛 📖 💵

      
_johndendron
🐛

      
_{Aaron Meese}
📖

      
_{Jeff Teter}
🐛

    

    

      
_{Mari Rajaram}
📖

      
_{Zero King}
💻 🐛

      
_benhsm
📖 💻

      
_icedwater
🐛 💻

      
_Bassmann
🐛

      
_Im
🐛

      
_{David Paquet Pitts}
🐛

    

    

      
_{John Wells}
📖

      
_{Luke Carrier}
🐛 📖 💻

      
_{maximilianigl}
🐛

      
_{byron wall}
📖

      
_{Carlos Cámara}
📖 🐛

      
_{Garran Plum}
🐛 💻

      
_tma66
💻

    

    

      
_not-so-smart
📖

      
_{Jules Sam. Randolph}
🐛

      
_{Mario Kahlhofer}
🐛

      
_{Anatoliy Kostin}
🐛

      
_r-good
🐛

      
_{Sagar Behere}
🐛

      
_{Nicklas Gummesson}
🐛 💻

    

    

      
_jquesada2016
🐛 📖

      
_{Phani Rithvij}
🐛

      
_Kumudan
🐛

      
_{Florian Beijers}
🐛 ️️️️♿️

      
_{Ryan Hill}
📖 🐛 💻

      
_{Jim Tittsler}
📖

      
_{Rick Berger}
🐛

    

    

      
_Thibault
🐛

      
_redsolver
🐛

      
_{NahomBefekadu}
🐛

      
_{jaroslavknotek}
🐛

      
_{Matthew Giallourakis}
🐛

      
_{Murtaza Nazir}
🐛

      
_emmjayvee
📖

    

    

      
_{Dan Gilleland}
📖

      
_Harman
📖

      
_{Adam G}
🐛 📖

      
_{Chisomo Chiweza}
🐛

      
_rzd-test
🐛

      
_{Carmen Bianca Bakker}
📖 💡

      
_KamQb
💻

    

    

      
_sahil48
🐛

      
_{Tsvetomir Bonev}
🐛 💻 🔧

      
_{I'm a lightbulb}
🐛

      
_James
🐛 📖

      
_{Callum Macdonald}
💻 🐛 📖

      
_Vik
💻

      
_{David Gomes}
🐛

    

    

      
_Binly42
🐛

      
_{Alexander Putilin}
💻

      
_{Pavel Vorona}
💻

      
_d1onysus
📖 🐛

      
_{Bill Moriarty}
🐛

      
_{Jamie Bilinski}
📖

      
_{Thanos Lefteris}
🐛 💻

    

    

      
_{Yi Seunggi}
🐛

      
_{Joshua Jeschek}
🐛

      
_{SkepticMystic}
🔧

      
_raeyulca
🐛

      
_{Sam Wagner}
🐛

      
_{Sai Kishore Komanduri}
📖

      
_{Shein Lin Phyo}
📖

    

    

      
_{Patrick Yates}
📖 💻

      
_{Trevor Sullivan}
🐛

      
_{Vincent Dansereau}
📖

      
_{Raffaello Fraboni}
🐛

      
_Xanaxus
🐛

      
_Gander7
🐛

      
_jgmpjgmp
🐛

    

    

      
_Non-J
🐛

      
_{Jody Foo}
🐛 📖 💡

      
_{Raymond K}
🐛

      
_{John Hoang}
🐛

      
_{Nickolay Kondratyev}
🐛

      
_mysoonyu
🐛

      
_gbieging
🐛

    

    

      
_oolonek
🐛

      
_Mettcon
🐛

      
_{LamentConfiguration}
🐛

      
_irishandyb
🐛

      
_PabloLION
💻

      
_{Dmytro Shapovalov}
📖 💡

      
_lexthanthree
📖 🐛

    

    

      
_GlitchByte
🐛

      
_{Steven Fan}
🐛

      
_{Lukáš Kucharczyk}
🐛

      
_{Daniel Brandenburg}
🐛 💻

      
_{Paolo Dina}
📖

      
_{Alexandru Ichim}
📖

      
_{Derek Ardolf}
📖

    

    

      
_huland
💻

      
_{Vaden Masrani}
🐛 🔣

      
_{Shane Perry}
📖

      
_aodhagan
🐛

      
_harrijer
🐛

      
_{P.J. Wu 吳秉儒}
🐛

      
_AshSimmonds
🐛 🖋

    

    

      
_ManuelSpari
🐛 💻

      
_{William Faunce}
🐛

      
_ebromberg
🐛

      
_{Steven Hilton}
🔧

      
_{Taran Lu}
🐛

      
_{Norbert Klamann}
📖

      
_{Marek S. Łukasiewicz}
📖 💻 🔧

    

    

      
_abunavas
🤔

      
_{Mihai Constantin}
🔧

      
_{riccardo dozzo}
🐛

      
_bugfixd
🐛

      
_{Kevin Fischer}
📖 🖋

      
_{Nikhil Jha}
🐛

      
_avhb
💻

    

    

      
_cquick01
🐛 💻

      
_Weiming
📖 ✅

      
_{José Longo}
🐛

      
_ං
🐛

      
_Phoebian
📖

      
_{Patrik Grip-Jansson}
📖 🐛

      
_{Robert van Kints}
🐛

    

    

      
_{Patrick Wilkie}
🐛

      
_{Michael Greene}
🐛

      
_{Bryan Lee}
📖

      
_Lodrus
🐛

      
_rogue2971
🐛 🖋

      
_doylejg
🐛

      
_Virile
🐛

    

    

      
_{Christophe Benz}
📖

      
_Tanamr
🐛

      
_cwtowns
🐛

      
_Henry
🐛

      
_{Brian Parma}
🐛

      
_{Vladimir Sanchez}
📖

      
_{Wilhelm Payne}
🐛

    

    

      
_{Yttrium ZHAO}
🐛

      
_{Sean Li}
💻

      
_bigheadghost
🐛

      
_Swithun
🐛

      
_{NuclearPowerNerd}
🐛

      
_{Vikram G}
💻

      
_ericthomas1
🐛

    

    

      
_jeep
🐛

      
_{Vianney Stroebel}
🐛

      
_mivanit
🔧

      
_tjr357
🐛

      
_Pedro
🐛

      
_JM-Laurel
🐛

      
_{Rob Lourens}
🐛

    

    

      
_{Emily Marigold Klassen}
🐛

      
_{Harshita Joshi}
🐛

      
_KitLeskinen
🐛

      
_{Wiktoria Mielcarek}
🐛

      
_{Allison Bellows}
🐛

      
_{Karsten Gresch}
🐛

    

  

([emoji key](https://allcontributors.org/docs/en/emoji-key)):

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. We welcome community contributions and pull requests. See the [Dendron development guide](https://docs.dendron.so/notes/3489b652-cd0e-4ac8-a734-08094dc043eb/) for information on how to set up a development environment and submit code.

## License

Dendron is distributed under the Apache License, Version 2.0.

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.