VSCODE Dendron 笔记个人知识管理工具插件快速使用指南

前言

Dendron 是一个开源的、本地优先的、基于 markdown 的笔记工具，它是专为开发人员构建的个人知识管理解决方案（PKM），可以与 VS Code 和 VSCodium 等 IDE 原生集成。

大多数 PKM 工具可以帮助你创建笔记，但一旦你的知识库达到某个阈值，就会想办法去检索它们。该阈值因工具而异，但几乎所有内容基本上在超过 10k 笔记后停止工作了，除非用户非常勤奋地组织他们的知识。

Dendron 建立在过去五年的编程语言和开发工具之上。我们将软件的关键经验应用于一般知识的管理。我们使管理通用知识（例如管理代码）和你的 PKM 像 IDE 一样。

设计原则

以开发者为中心：Dendron 旨在为管理知识创造世界级的开发人员体验。我们的目标是提供一个具有 Vim 的效率、Emacs 的可扩展性和 VS Code 的可访问性的工具。这意味着什么：

Dendro 以文本为中心且可组合
Dendron 为你的知识库工作提供了摩擦力最小的界面
Dendron 优化效率、速度和以键盘为中心的用户体验
Dendron 具有健全的默认设置和根据你的喜好进行自定义的能力
树枝可以沿任何维度延伸

渐进式结构

Dendron 使用结构原语扩展了 markdown，使其更易于大规模管理，并在顶部使用工具来使用此结构。

不同的知识库需要不同级别的结构 - 用于保存日常日志的 PKM 与数千名开发人员使用的公司范围的知识库不同。

Dendron 适用于任何级别的结构，这意味着你可以在开始时进行自由形式的笔记，并随着您的知识库的增长逐渐增加更多的结构。

灵活和一致：Dendron 既灵活又一致。它为你所有的笔记提供了一个一致的结构，并让你可以灵活地改变这个结构。

在 Dendron，你可以重构笔记，Dendron 会确保你的 PKM 在整个过程中是一致的。这意味着你拥有两方面的优点：一个基本的组织结构，但又可以灵活地改变它。

特性

Dendron 有数百种功能，以下是一些比较亮眼的特性。

纯文件

使用 git 进行管理
使用 git blame 来查看个别编辑
用任何可以处理文本文件的软件进行编辑（例如 Vim）
Markdown

使用 Mermaid 创建图表

用 katex 编写数学相关数据
在多个地方嵌入笔记（和笔记的一部分）

查询

用一个统一的方式来查找和创建笔记
快速浏览和创建新的层次结构

模式

确保你的知识库的一致性
在创建新笔记时获得自动提示
创建时自动将通用模板应用于笔记

导航

使用反向链接探索关系
导航到注释、标题和任意块
使用图形视图可视化你的知识库

重构

重组你的知识库而不破坏链接
使用任意的重构词重新命名单个笔记或重构内容
重命名和移动笔记中的各个部分

保险箱

使用保险箱来混合和匹配知识，这是一个有 git 支持的文件夹，用来存放你的笔记
使用保险箱来分离关注点，比如个人笔记和工作笔记
在 git 上发布保险箱，与他人协作和分享知识

发布

将你的知识库导出为静态（nextjs）站点
在本地查找并通过生成的链接在全球范围内共享
使用每个保险库、每个层次结构和每个注释的细粒度权限管理你发布的内容

安装

使用

创建 Note 工作区 ：Ctrl+Shift+P ， 输入 Dendron: Initialize Workspace 命令。

创建 Note ： Ctrl+L/Cmd+L 输入新 Note 名称，回车。

Note 元数据：文件开头 -- 开始结尾的内容，默认内容不要修改。

创建 Note 层次结构：Ctrl+L/Cmd+L 输入如“vscode.Dendron 使用教程”。层次结构是通过文件名中使用.分隔符创建的。

查找 Note：Ctrl+L/Cmd+L 输入 Note 名称。

全文搜索：Ctrl+Shift+F/Cmd+Shift+F，它利用了 VS Code 内置的搜索功能。

链接 Note：键入如：[[vscode.Dendron 使用教程]]，Dendron 会自动将该链接注册为目标 Note 的反向链接。当目标 Note 打开时，这些 Note 将显示在反向链接窗格中。

链接到标题：键入如：[[vscode.Dendron 使用教程#前言]]，[[这是链接显示的文字|vscode.Dendron 使用教程#前言]]。把光标定位到 Note 的某个标题中，Ctrl+Shift+C/Cmd+Shift+C 可以快速复制该标题的链接。

反向链接：工作台的 Backlinks Panel，

快捷切换: Ctrl+Tab

打开 MD 预览：Ctrl+K V

显示 Note 图谱：Ctrl+Shift+P ， 输入 Dendron: Show Note Graph 命令。

重命名 Note： 先定位选中到如“vscode.Dendron 使用教程”文件，然后Ctrl+Shift+P，输入 Dendron:Rename Note 命令，输入新的名称或目录结构，如“vscode.Dendron 使用指南”，“VS.Dendron 使用指南”。

重命名标题：将光标定位到文章标题上，如“vscode.Dendron 使用教程#前言”,然后Ctrl+Shift+P，输入 Dendron:Rename Header 命令.

重命名层次结构：将光标定位到层次结构上，如“vscode”,然后Ctrl+Shift+P，输入 Dendron:Refactor Hierarchy 命令，先输入目录名称，然后输入要修改的名称，最后确认。

如先输入“recipes.vegetarian”，再输入“recipes.indian”，得到下面的结果：
recipes.vegetarian.md --> recipes.indian.md
recipes.vegetarian.tikka-masala.md --> recipes.indian.tikka-masala.md
recipes.vegetarian.aloo-paratha.md --> recipes.indian.aloo-paratha.md
recipes.vegetarian.dosa.md --> recipes.indian.dosa.md

Markdown 语法：

Dendron 涵盖了 GitHub Flavored Markdown（GFM）中的所有内容：https://github.github.com/gfm/
也包含 Dendron 独有的其他功能。

基本表格语法：
|Formatting|Example|
|:---|:---:|
|Bold|**Hello World**|
|Italics|_Hello World_|
|Strikethrough|~~Hello World~~|

图像粘贴插件：Dendron Paste Image Linux： xclip 或 wl-paste。

公式插件：Katex

图表插件：mermaid

引用 Note 参考：![[vscode.Dendron 使用教程]] , ![[vscode]]