Dendron 入门指南:五步掌握层级笔记、双向链接与知识图谱(Getting Started 教程全解)

发布时间:2026/9/28 3:46:41
Dendron 入门指南:五步掌握层级笔记、双向链接与知识图谱(Getting Started 教程全解) 知识管理知识库【免费下载链接】dendronThe personal knowledge management (PKM) tool that grows as you do!项目地址https://gitcode.com/gh_mirrors/de/dendron点击查看免费下载本指南以 Dendron 插件内置的Getting Started 教程位于packages/plugin-core/assets/dendron-ws/tutorial/treatments/no-refactor/为骨架逐章讲解教程的五个步骤认识 Workbench 用户界面、创建带层级的笔记、用 wikilink 编织双向链接、使用 Markdown 之外的丰富格式语法以及最后的收尾与进阶路线。读完本文你将掌握 Lookup 快速检索/创建笔记、用.分隔符构建层级、利用 stub 占位符、插入图片公式与 Mermaid 图表、通过 Note References 复用笔记片段并理解这些能力在 Dendron 插件源码中是如何被加载与实现的——这套教程本身就是随插件分发的真实工作区模板可直接上手练习。教程机制Getting Started 从哪来如何被启动Dendron 的入门教程不是一个静态网页而是一套预置的教程工作区tutorial workspace。插件在创建教程工作区时会调用 LaunchTutorialWorkspaceCommand它优先在用户主目录下生成~/Dendron目录若路径被占用则自动追加数字后缀然后通过SetupWorkspaceCommand配合TutorialInitializer完成工作区初始化。真正的教程内容由 tutorialInitializer.ts 负责注入const tutorialDir TutorialInitializer.getTutorialType(); fs.copySync( path.join(dendronWSTemplate.fsPath, tutorial, treatments, tutorialDir), vpath );也就是说插件把assets/dendron-ws/tutorial/treatments/类型/目录整体拷贝进新工作区的 vault里面就是完整的教程笔记集合。其中treatments下并存了多个变体main、no-refactor、original、quickstart-skip-welcome、quickstart-v1、quickstart-with-lock等从源码中CURRENT_TUTORIAL_TEST与getUserGroup的调用可以看出选择哪个变体由 A/B 测试分组决定未进入实验组时默认使用MAIN_TUTORIAL_TYPE_NAME。本文所讲的 no-refactor 版教程 是标准五步流程。工作区打开后onWorkspaceOpen会自动打开 vault 根目录下的 tutorial.md即 Getting Started 首页并延迟约 1 秒后通过TogglePreviewCommand打开右侧预览视图。值得注意的是每一篇教程笔记的 frontmatter 都带有currentStep、totalSteps、nav_order等字段例如入口笔记currentStep: 0, totalSteps: 5插件用 getAnalyticsPayloadFromDocument 读取这些字段在用户切换编辑器时上报TutorialNoteViewed埋点当currentStep totalSteps即看完总结页时还会弹出 Obsidian 导入提示。因此这套教程不仅是教学内容也是 Dendron 团队观测新手转化路径的探针。教程目录速览文件步骤核心内容tutorial.md0/5入口Dendron 是什么tutorial.user-interface.md1/5Workbench 七个面板tutorial.taking-notes.md2/5Lookup、层级、stub、模糊搜索tutorial.linking-notes.md3/5wikilink、标头链接、知识图谱tutorial.rich-formatting.md4/5图片、公式、图表、Note Referencestutorial.conclusion.md5/5收尾与进阶路线第 1 步认识 Workbench 用户界面Dendron 的运行界面被称为Workbench它是构建在 VS Code 之上的一组工作区视图。进入教程后你会同时看到以下面板它们各有分工1. Editor View编辑器视图书写和编辑笔记的地方。Dendron 的笔记本质上是 Markdown 文件如my.note.md编辑体验与普通 Markdown 完全一致。2. Preview View预览视图实时渲染当前打开笔记的 Markdown 效果。如果关闭了该面板可通过命令Dendron: Show Preview重新唤出。预览底部通常还有两个区块——Children子笔记和Backlinks反向链接在后续步骤中会详细介绍。需要注意预览视图是只读的所有编辑都必须在编辑器视图中完成。3. File Explorer Pane文件资源管理器展示 vault 中的文件和文件夹。vault仓库是存储笔记与资产图片、PDF 等的目录。教程建议浏览笔记时优先使用下面的树视图Tree View而不是文件资源管理器。4. Outline Pane大纲面板按标题列出当前笔记的大纲点击标题即可在长文档中快速跳转。5. Calendar View Pane日历面板标出你创建过Journal日志笔记的日期如果某天还没有日志条目点击对应日期会自动创建一篇每日日志。6. Tree View Pane树视图面板以层级树的形式展示笔记——类似于文件系统里的文件夹结构是教程强烈推荐的主导航方式。值得注意在教程工作区激活时插件会主动执行dendron.treeView.focus把焦点引导到树视图上见 tutorialInitializer.ts让新手第一时间发现该功能。7. Backlinks Pane反向链接面板列出所有链接到当前笔记的其他笔记是知识图谱在 UI 层的最直观体现。从源码结构看反向链接的计算逻辑集中在 BacklinkUtils.ts它负责从 vault 中解析出指向某篇笔记的全部 wikilink。TIP不熟悉 VS Code 的话先记住命令面板的快捷键CtrlShiftP/CmdShiftP——本教程里所有Dendron: xxx命令都可以在这里输入命令名直接运行。另外 VS Code 允许你随意拖拽重排这些面板布局完全由你掌控。第 2 步创建笔记与理解层级教程的第二步围绕三个动作展开用 Lookup 创建笔记、用 frontmatter 加元数据、用.构建层级。访问 Lookup BarDendron 的核心交互入口是Lookup 栏Dendron: Lookup快捷键CtrlL/CmdL。它既是查找器也是创建器输入名字可以打开已有笔记输入不存在的名字则可以新建笔记。创建一篇笔记按CtrlL/CmdL打开 Lookup 栏输入新笔记的名称例如recipes点击Create New或直接回车确认新建按Enter确认。系统即创建recipes.md光标停留在笔记正文中可以直接开始写内容。TIP用CtrlTab/CmdTab可以快速切回之前浏览的笔记。INFODendron 的笔记就是本地文件系统上的纯文本 Markdown跨操作系统、跨软件可移植也方便后续导入导出甚至可以发布成托管网站。用 frontmatter 为笔记附加元数据每篇笔记顶部的---区块被称为frontmatter。它由 Dendron 在创建笔记时自动生成用来存放该笔记的元数据例如教程笔记自身的元数据--- id: tbilk9to67d0dwgnjanj5ph title: Getting Started desc: updated: 1653980839862 created: 1608051264282 currentStep: 0 totalSteps: 5 nav_order: 1.1 ---你可以按需增删自定义属性但务必遵守以下规则不要修改id和createdid是笔记的唯一标识created记录创建时间篡改会导致笔记关联错乱updated会自动更新每当文件发生修改Dendron 都会自动刷新该时间戳其余title、desc、tags、custom等字段均可自由使用更多保留键reserved keys的说明可参考项目文档中的 frontmatter 规范。用.构建层级HierarchyDendron 用文件名中的.点分隔符来表达层级。例如一个传统文件树. └── project1/ ├── designs/ │ └── promotion.png ├── paperwork/ │ └── legal.md └── tasks/ ├── task1.md └── task2.md在 Dendron 中同样的结构由一系列点分隔的 Markdown 文件表达. ├── project1.md ├── project1.designs.md ├── project1.designs.promotion.md ├── project1.paperwork.md ├── project1.paperwork.legal.md ├── project1.tasks.md ├── project1.tasks.task1.md └── project1.tasks.task2.md创建层级的操作与创建普通笔记完全一致按CtrlL/CmdL打开 Lookup 栏输入带.的名字例如recipes.vegetarian存放素食菜谱按Enter。这样recipes.vegetarian.md就诞生了——你的第一个层级TIPLookup 支持 Tab 自动补全。输入rec后按Tab会自动补全为recipes。创建完成后打开Tree View可以看到vegetarian挂在recipes层级之下文件资源管理器里也能找到recipes.vegetarian.md。查看子笔记Children在上述例子中vegetarian是recipes的子笔记。打开recipes笔记时预览视图底部会把vegetarian以及所有recipes.*笔记列为Children子笔记同样可以在树视图中展开浏览。在任意层级创建笔记层级可以建得很深。比如在 Lookup 中输入recipes.italian.desserts.tiramisu并回车你会看到italian和desserts旁边出现一个号——这表示它们是stub占位符。stub 是尚未真正创建的笔记占位Dendron 用它在不产生一堆空文件的情况下把层级骨架先立起来等你真正需要时再填充内容。这避免了文件系统被空笔记污染是 Dendron 层级体系的关键设计。按同样方式可以继续扩展菜谱库recipes.favorites recipes.italian.appetizers recipes.chinese recipes.chinese.appetizers.wontons recipes.ingredients.favorites recipes.ingredients.shopping-list查找笔记模糊搜索查找笔记同样走 Lookup按CtrlL/CmdL打开 Lookup 栏输入笔记名例如输入vege即可命中recipes.vegetarian按Enter打开笔记。INFOLookup 采用模糊搜索fuzzy search支持只输入部分关键词也支持用空格分隔的多关键词且不要求顺序——例如vege rec与rec vege都能匹配recipes.vegetarian。多数查询在 Lookup 内即可完成如果你需要对笔记正文内容做全文检索可改用 VS Code 内置搜索CtrlShiftF/CmdShiftFSearch: Find in Files。内置笔记类型Meeting NoteDendron 还内置了一些常用笔记类型。例如经常记录会议纪要的话运行命令Dendron: Create Meeting Note它会基于预置模板生成一篇带会议结构的笔记可以直接套用。第 3 步链接笔记构建知识网络链接是让笔记从文件夹升级为知识图谱的关键。创建 wikilink在编辑器里输入[[Dendron 会自动弹出工作区内可链接的笔记列表。以[[recipes.vegetarian]]为例示例中的反引号仅为排版需要使用时去掉在预览视图中直接点击链接即可跳转在编辑器视图中把光标移入链接内按CtrlEnter即可跳转如果目标笔记尚不存在Dendron 会直接创建它想返回上一篇笔记用CtrlTab/CmdTab。TIP创建 wikilink 时Dendron 会自动为目标笔记注册一条backlink反向链接。当目标笔记被打开时这条链接会出现在 Backlinks 面板中。反向链接的计算与维护可在 BacklinkUtils.ts 中查看。链接到标题Headerwikilink 还能精确指向某篇笔记中的某个标题。操作步骤给[[recipes.italian.desserts.tiramisu]]添加一个## Ingredients小节若[[recipes.ingredients.shopping-list]]不存在则先创建它在shopping-list中加入链接[[Tiramisu Ingredients|recipes.italian.desserts.tiramisu#ingredients]]。结尾的#ingredients会直接定位到目标笔记的## Ingredients标题。更省事的做法是把光标放在## Ingredients标题处运行Dendron: Copy Note LinkCtrlShiftC/CmdShiftC链接会复制到剪贴板直接粘贴到其他笔记即可。TIP[[Tiramisu Ingredients|recipes.italian.desserts.tiramisu]]这种带自定义显示文本的写法称为labelled wikilink语法是[[label|目标笔记]]。不写 label 时Dendron 会回退使用目标笔记 frontmatter 中的title或目标标题本身。探索知识图谱Note Graph运行Dendron: Show Note Graph可获得笔记的可视化图谱直观看到层级结构与笔记之间的链接关系。图谱有两种形态Local Note Graph局部图谱展示当前笔记及其直接相邻的笔记是运行Show Note Graph时的默认视图Full Note Graph完整图谱展示全部笔记的全貌在命令面板中切换该选项即可激活。图谱与树视图互为补充树视图强调层级归属图谱则强调链接关系两者共同构成组织、参考、复用任意规模知识的基础设施。第 4 步超越 Markdown 的丰富格式Dendron 完整支持 GitHub Flavored MarkdownGFM并在此基础上扩展了一批独有语法。练习时请打开预览视图Dendron: Show Preview实时查看渲染效果。基础排版与表格| Formatting | Example | | :------------ | :-------------: | | Bold | **Hello World** | | Italics | _Hello World_ | | Strikethrough | ~~Hello World~~ |渲染结果FormattingExampleBoldHello WorldItalicsHello WorldStrikethroughHello World粘贴图片ACTION复制任意一张图片到剪贴板然后在编辑器面板中执行Paste Image命令。Dendron 会自动生成图片链接并把图片文件存入工作区的 assets 目录。示例链接格式[![Dendron Logo](https://raw.gitcode.com/gh_mirrors/de/dendron/raw/4420715a421756518863c47005c8c49a38e37621/packages/plugin-core/assets/dendron-ws/tutorial/common/assets/images/logo_small.png?utm_sourcegitcode_repo_files)](https://link.gitcode.com/i/e47a448d6c71922b37f965bd41849030)本教程工作区的示例素材即存放在assets/images/下TIP该功能依赖随 Dendron 一并安装的Dendron Paste Image扩展。Linux 用户需要额外安装xclipX11 环境或wl-pasteWayland 环境否则剪贴板读取会失败。数学公式KaTeXDendron 通过 KaTeX 支持数学排版使用$$包裹行内块级公式例如$$ \int_{-\infty}^\infty f(x)dx $$图表Mermaid借助 Mermaid 语法可以绘制多种图表。以下是一个流程图![mermaid](https://web-api.gitcode.com/mermaid/svg/eNpLL0osyFAIcbHmUgACR11dOycE09kaAHpwBsc)以及一个时序图![mermaid](https://web-api.gitcode.com/mermaid/svg/eNpljTsOgzAMhveewuzNBRiCqCoVcQsTLIjkxpAmqrh9nQww1JP1_a8P7ZmCo6fHJeL7BnobxuSd3zAk6Nk7-qMPmSqrqrF2lDW0MBCzQPnvsMoXMBIckrtqLdiotUZaeEXC1FyKtdqpFSU2SU5XULk5J0ZhPmARmZsfpb45vA)代码块Markdown 原生支持带语法高亮的代码块指定语言标记后编辑器与预览视图都会呈现对应的语法着色# Whoa, Im doing math in Python result 2 2 print(result)# Whoa, this is a code block explicitly ## stating it is in bash! echo This is a bash example! ps -ef | grep codium如果不写语言标记代码块同样可以正常显示只是没有高亮# Whoa, this is still bash, but without ## it explicitly stated on the first line! echo This is a bash example! ps -ef | grep codium笔记引用Note ReferencesNote References 是 Dendron 独有的语法它可以把另一篇笔记或其某个段落内联嵌入到当前笔记中。渲染 Markdown 与这些扩展语法的处理管线位于 packages/unified 的 remark/rehype 插件体系中。动手试一下创建[[recipes.favorites]]写入以下内容My favorite recipes, by far. I must avoid. - [[recipes.italian.desserts.tiramisu]] - [[Chinese Wontons|recipes.chinese.appetizers.wontons]]在[[recipes]]中追加## Favorites ![[recipes.favorites]]回到预览视图查看效果——recipes.favorites的完整内容会直接内联渲染在recipes的## Favorites小节之下。TIPNote References 还可以更精细地只引用目标笔记的某个标题、小节或文本块从而做到一处书写、多处复用非常适合维护手册、变更日志这类高频引用的内容。第 5 步收官与下一步完成以上四步后教程就结束了。恭喜你已经掌握快速 Lookup、灵活层级、笔记链接和丰富格式——这套组合足以支撑组织、引用、处理任意规模知识的工作流。从这篇教程工作区出发你可以直接在当前工作区继续添加自己的笔记想彻底重来时运行Dendron: Initialize Workspace命令新建一个干净的工作区尝试发布PublishingDendron 不仅用于本地笔记也能把笔记发布成静态网站——Dendron 官方文档与博客即以此为载体。仓库中的 nextjs-template 就是基于 Next.js 的发布模板实现其 README.md 与构建脚本scripts/buildStatic.js可作参考沿着教程总结页列出的Trail小路/ Forest森林/ Wilderness荒野三级路线继续深入从 Amoeba 工作流、标签体系、任务笔记、日记笔记到 Lookup 修饰符、frontmatter 属性、多 vault 管理、Pods 导入导出再到团队协作、Hooks 扩展与 RFC 设计讨论。这些进阶主题大多与教程工作区同源——例如test-workspace中的 daily.journal.* 系列与 template.* 系列笔记就是日记、模板、schema 等机制在仓库内的活样本可以对照阅读。至此你已完整走通 Dendron 的入门路径下一步就是让这套体系为你的知识库真正运转起来。赞分享知识管理知识库【免费下载链接】dendronThe personal knowledge management (PKM) tool that grows as you do!项目地址https://gitcode.com/gh_mirrors/de/dendron点击查看免费下载相关推荐klog 完全指南从 glog Fork 到 Kubernetes 分级日志库在 KubeSphere 中的实战应用klog 完全指南从 glog Fork 到 Kubernetes 分级日志库在 KubeSphere 中的实战应用 导读 klog k8s.io/klog知识管理知识库Zotero-Better-Notes双向链接笔记系统构建个人知识图谱的终极指南Zotero Better Notes双向链接笔记系统构建个人知识图谱的终极指南 在信息爆炸的时代如何高效管理海量文献和笔记成为每个研究者和学习者的痛点。Z知识管理知识库AI 写作双向链接与知识图谱Digital Gardeners 核心技术解析双向链接与知识图谱Digital Gardeners 核心技术解析 数字花园 正在重新定义个人知识管理的方式通过 双向链接 和 知识图谱 技术让笔记不再是文档上一篇ComfyUI ReActor 换脸节点实战教程5 分钟装好从克隆到出图一次跑通下一篇深蓝词库转换全攻略50 格式词库一键互通创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考