提示\
花园中我挖了很多坑，也有不少种子还在萌芽阶段，这里我尽量将已经成熟的花草展示给您。但也许您漫步着漫步着，就踩到了一些坑和种子，还请不要难受和愤怒。若您希望我加速填某些你感兴趣的坑，欢迎来交流讨论：Discussions · oldwinter/knowledge-garden · GitHub
阅读小贴士：如何阅读由双链笔记组成的文章
持续迭代中，🏗 本库Roadmap
将本库作为 obsidian 示例库进行借鉴
看我感兴趣领域的笔记
提示\
本库不搞任务管理、美化排版等。尽量聚焦文本内容本身，使用起来相对简单。即便如此，若您看完本页内容后，依旧遇到了使用上的疑问，欢迎来交流讨论：Discussions · oldwinter/knowledge-garden · GitHub
若你英文尚可，我更推荐你将obsidian的语言设置为英文，习惯习惯就好了。因为不管是官方核心插件，还是第三方社区插件，都是第三方爱好者翻译的，质量很难有保障，我的体验是有些中文翻译甚至还给我带来误导。若有英文配置不懂，你直接截图发给AI，甚至更有效。
此外，本库中如果跟Obsidian以及插件的设置相关的文字，除非中文没有任何歧义，我一般习惯使用英文来表述，请注意。
阅读小贴士：如何阅读由双链笔记组成的文章
兼容性说明：本库在不同操作系统下兼容性的说明
更新目标：做一个面向有独立思考能力的大学生以及职场新人的完全免费的开箱即用库，顺便找到同频者以及获得和优秀年轻人交流的机会。
本库使用指南将围绕以下 3 个方面展开：
- 如何高效使用 obsidian 软件本身。
- 如何构建个人的第二大脑/知识库。
- 如何将自己的数字花园/知识库发布分享出来。
Obsidian：使用篇
本库目录及插件介绍
Obsidian 从入门到放弃
看了上面这些入门内容，也许已经一个月过去了😅。入门后才建议继续看本库其他 obsidian 相关内容，否则可能会浪费你的时间⏰。
本库极力不推荐的做法
- 本库不建议在obsidian中搞太多奇技淫巧
- 本库不建议在obsidian中搞美化和排版
- 本库不建议在obsidian中搞任务管理
- 本库不建议在obsidian中搞homepage仪表盘主页
- 本库不建议在obsidian中做Iframe嵌入
- 本库不建议在obsidian中搞专属定制
本库基本配置和插件
从这里开始，您可以选择直接启用安全模式，也就是关闭全部第三方插件，此时本库依旧能正常使用。接着可以自己按需逐步一个个开启第三方插件，进行渐进式的探索学习。
本库界面设计逻辑
注意：左侧ribbon功能区，我已完全关闭，若要使用命令，请通过cmd + p命令来，这是一个更高效的做法。更高频的命令，使用Commander插件pin在编辑区右上角吧。 若你要找回ribbon区，一方面是主题可能有控制，请切换其他主题；另一方面是Obsidian-Appearance设置中进行打开。
本库的工作流
obsidian 的缺点及优点
如果你看到这里，应该已经爱上 obsidian，且使用了有一段时间了吧？它有时候很强，但有时候又很弱。是不是很像我们深爱着的另一半？像有了铠甲，也有了软肋。
增补
第二大脑：理论篇
本库设计哲学、理念及核心原则
如果你认同我的使用理念，再往下阅读，否则直接出门左转给自己节约一点时间会比较好🤣。
数字花园：分享篇
本库打造过程中参考的方法论
- 双向链接怎么用，卡片笔记怎么记：
- PKM流程怎么设计：
- Obsidian中的PKM具体怎么操作：
有言在先
- 以下涉及到使用云服务部分，普通流量级别肯定都是完全免费的，但如果你是每天有几千个访客的大V，那也许就不太够了。
- 其次，这些服务的使用，其实都非常的小白化，只要你勤于动手会思考，懂的善用搜索引擎解决问题，使用这些服务没有任何门槛可言。
- 这些教程面向跟我一样今年第一次搞网站建设以及有一些建站经验的朋友们做参考。但是，我自己不会去写那种图文并茂的一步步的傻瓜式教程，我只提供思路、相关教程和结果。如果你适应不了，趁早离开，节约时间😅。
- 这些教程，我可以确保是2022年当下，我能找到的最优最简单的实现，那种几年前可能就已经被淘汰的服务，或者要花大量时间自己折腾的方案，我是断然不会用的。可以理解为，本系列教程，旨在提供一套完整的个人网站建设的解决方案，也可以理解为数字花园建设的最佳实践路线。
- 这些教程算是我的常青笔记，只要我还在使用这些云服务，我就会一直持续更新。
本库当前的发布方案使用现状：
共3个发布地址：
- https://oldwinter.top
- 是官方obsidian publish 发布方案。
- 无发布代码。通过obsidian自带的发布核心插件进行发布操作。
- 更新，已经到期，暂停使用，重定向至 https://garden.oldwinter.top
- https://garden.oldwinter.top
- 是obsidian quartz发布方案。
- 代码托管地址是： https://github.com/oldwinter/dg3
- 免费部署在 Netlify
- 现在可通过quartz syncer发布，方便很多
- 是obsidian quartz发布方案。
- https://notes.oldwinter.top
- 是obsidian jekyll发布方案。
- 代码托管地址是： https://github.com/oldwinter/dg
- 免费部署在Vercel
- 虽然lev8.com 前端 SEO优化效果很棒，但是这个方案维护太困难，不更新新笔记了。
- 是obsidian jekyll发布方案。
发布流程
- 编辑完成后，优先发我的小红书。
- 接着给要同步的md文件，使用quartz syncer插件打上
publish: true的properties，并使用publication center命令进行发布。这些publish文件，会自动复制到dg3仓库content目录，dg3仓库自动触发netlify更新。 - 接着额外标记需要发布的其他非md文件，创建一个同名空文件并加上
.publish后缀，然后执行根目录的publish_by_frontmatter.py脚本，将以上文件同步刷写一份儿到knowledge-garden仓库中。
发布教程
以下是当初在众多双链笔记软件中选择它的初始原因，即初心。
- 第一眼，类似VSCode界面，有亲切感。当然，根本原因其实就是极其灵活的多窗口支持啦。多窗口，在非虚构类写作场景下十分便捷有用，同时参考多条笔记及其上下文，在我写作思路卡壳时极其有用。
- 极其克制的markdown语法定制，使其对用博客等发布文章的场合极其友好。毫无疑问，其他双链笔记，要么对md文件本身做了较多定制化修改（logseq），要么直接改成json或数据库格式存储数据（思源笔记）。只有obsidian，是可以直接把md文件发到博客网站上直接完美支持，而不需要做修改的。
- 当然，刚接触那会儿，我还没意识到，这种克制，也带来了很大牺牲，细粒度的块引用功能就完全无法与其他双链笔记抗衡。但我使用至今，也确实还没感受到块引用功能的必要性，对我而言，基于文件级别的双向链接就已足够。
- 用户规模大且社区活跃。碰到问题，搜一搜社区，总能带来惊喜，无需自己反复踩坑或者重复造轮子解决问题。比如markdown格式自动化的插件，比如输入自动提示的Various Complements插件，不一而足。
- 当然，换个角度理解，也可以认为过度发达的插件社区，也能证明obsidian本体的某些功能的缺失和不完善。但我觉得这个度，obsidian开发者把握得挺好。
其他的原因，可能也是一部分，但都没有这3个原因这么根本，我看过一个视频，也许对你选择入坑什么笔记软件有所帮助：📹放弃roam用obsidian的理由
在使用了一段时间后，发现一些缺点，当然也进一步发现一些优点：
up:: 🧰 本库使用指南
都2022年了，入门最快的方式是看视频
- Johnny学的入门课：Johnny学的公开课 第一集 将近3小时的Obsidian小白入门课，都是基础知识，学会了就能上手OB，一个社区插件都没讲_哔哩哔哩_bilibili
- 别傻傻的一集一集慢慢看，讲到会的或你不感兴趣的内容跳过即可。绝对不要只看视频，要跟着一起动手操作，这很重要。
- 也许是B站最好的Obsidian新手教程！爆肝30天，一站式入门双向链接笔记软件_哔哩哔哩_bilibili
- 看看这个视频，爽一爽，也许更能让你下定决心开始学习obsidian。爽归爽，我自己是只使用了视频中提到的20%不到的功能。
- 后续使用和学习过程中，如果某个问题或方案非常具体，那么，请相信我，B站或youtube一定有人做了相关教学视频，善用搜索。比如：zotero、markdown、slides等等关键词。
边看视频边动手实践，有问题在文档中搜关键词
- 快速过一遍官方帮助文档：Obsidian Help
- 其实跟着官方帮助文档，动手操作一遍，于我（程序员、且对效率工具比较熟悉）个人而言，是最快的上手方式。
- 实践过程中，遇到问题，可以先搜索一下落山鸡的帮助文档，很全面：Obsidian中文教程 - Obsidian Publish
- 其他各种文章，基本都能在落山鸡的帮助文档中搜到索引。再次用文字感谢这个🐔。
- 这位小姐姐写的一系列入门文章深入浅出，单拎出来推荐一下：莉莉安Obsidian文章MOC - 经验分享 - Obsidian 中文论坛。
- 如果对插件情有独钟，这位台湾朋友，做了将近100个视频讲解各种插件的使用：简睿学堂-emisjerry的个人空间_哔哩哔哩_bilibili。关键在于，他每个视频都配了文章，小白看视频，老鸟看文章，各取所需，学习效率杠杠的。
- 新增，咖啡豆obsidian入门指南写得很详尽很用心 https://coffeetea.top/zh/
然后看看别人的示例库
- obsidian开箱即用示例库
- 各种示例库也是做的大而全，且美化为主，请注意不要迷失，选择对自己有用的东西模仿和学习即可。时刻提醒自己，你的笔记库，第一目的是服务自己，帮助自己更好地思考、提问和决策，不是为了美化给别人看获取认同的。
最不推荐的方式，但这里还是要提一下
加各种qq或微信群。但要注意，99%讨论的内容跟你关系不大，所以加这类群，请注意自己的目的，应该是更快地获取资源或信息，避免迷失浪费太多时间跟群友扯淡。
- 1千人的qq群号：774176839
- b站Johnny学，他有多个500人微信新手群。私聊他即可。
- b站沙牛，也有多个500人微信新手群，加他助手微信即可入群。
- 还有个『维客笔记』公众号，搞了个知识星球，有兴趣可以关注看看。
相对有价值一点的方式是discord，开发者和所有的活跃核心用户都聚集在此，但是是英文交流环境，且需要翻墙。
- discord地址在官网community下：Community - Obsidian
只选个人认为重要的配置项，说明原因。
编辑器
- 默认视图：编辑视图
- 默认编辑模式：实时预览
- 90%场景用所见即所得的编辑模式。看dataview代码、编辑表格等场景，切到源码模式。
- 有个使用技巧不得不提。预览模式下，点击链接是当前页打开，而如果用cmd修饰键点击链接是新建tab页打开，但有个更常见的使用场景是：当前页面做为MOC，点击链接在其他tab打开，且点击其他链接也不会新建tab页面。只需要将当前文件进行『锁定/pin』操作即可。
- 缩减栏宽：开
- 少数派、notion等等各大主流网站的风格都是这一种，咱不搞特立独行。而且确实这种宽度阅读体验比较好。
- 严格换行：开
- markdown行尾2个空格+回车的换行习惯已经沿袭下来，改不了了。并且打开的话，markdown直接粘贴到其他任何网站，都没有发生格式问题。如果关闭，有些网站可能会不兼容。
文件与链接
- 始终更新内部链接：开
- 双链流畅使用的根本原因之一。请勿在obsidian外，例如系统文件管理里面进行文件重命名，会导致引用该文件的链接没有自动修改而失效。
- 新建笔记的存放位置：当前文件所在的文件夹
- ∑ 本库 ACCESS 工作流汇总提到，为了避免孤立文件的产生，只推荐在文件中（例如DailyNote和MOC文件中），通过双链语法直接新建文件，这样新生成文件至少和当前文件是连接的，并且新生成文件和当前文件处于同文件夹，让文件组织更有序。所以需要用这个配置项。
- 内部链接类型：尽可能短的形式
- 这个形式，引导我们去忽略路径，让链接成为我们笔记的第一公民，即链接优先。若你对传统文件夹，即folder first模式依依不舍，则更改成其他选项。
- 使用wiki链接：开
- 即wikilink的形式：
[[]]。使用起来更为方便，2个中括号就可以搜索库里的一切文件，爽。但传统的blog如hugo、jekyll、gatsby等还是支持[]()格式为主。但不必担心，若需要用到，你总能转到自动转换的解决方案的。
- 即wikilink的形式：
- 附件默认存放路径：指定的附件文件夹
- 做笔记，请让文字成为99%占有率的第一公民。其他图片、视频、pdf等，统一放在一处后，可以发挥obsidian的local first的特长，例如用devonthink或billfish等软件统一管理这些非md文件。
外观
- 主题使用，见本库使用的主题及原因。
- 字体使用。
- 已经过了各种折腾的年纪，于我而言，字体默认往往就是最适合我的。80%默认优先，20%深度定制。
- CSS代码片段。
- 菜单栏定制：目前主要去掉了菜单栏左上角的前进返回按钮，因为这组按钮，在页面菜单栏使用更符合逻辑。
- 2023-02-27：ob的1.0版本果然也去掉了最左上角的前进返回按钮，跟我原来的使用想法一模一样。
- 隐藏xx文件：根目录有些LICENSE文件或其他依赖，平时不用动又不想看到它们。
- supercharged-links-gen：插件自动生成，为各种特定的内部链接增加emoji和颜色，可以在搜索时更快找到重要内容。
- 菜单栏定制：目前主要去掉了菜单栏左上角的前进返回按钮，因为这组按钮，在页面菜单栏使用更符合逻辑。
快捷键
核心插件
第三方插件
如果一脸蒙逼不知何处下手，不妨先关闭安全模式，然后你会发现，其实本库没有第三方插件，好像也能正常使用。哈哈哈。
写下常青笔记并加以组织，意在时过境迁，世事辗转之中，这些笔记仍能演化改良，发挥功用，最终聚沙成塔。如此考虑笔记实属不寻常：大多数人只写临时的笔记。写常青笔记，与其说是写笔记，不如说是高效发展洞察力：更好地记笔记这个描述太过流于表面；核心在于更好地思考。常青笔记写得好则会颇富价值：常青笔记是知识工作的基本单位。
写出经得住长久研磨改善的笔记，实属不易。下面这些原则可能有所帮助：
常青笔记这一概念在很大程度上是由尼克拉斯-卢曼的卡片盒笔记法演变而来，尼克拉斯-卢曼认为，在他 70 本书的写作过程中，Zettelkasten 就像一个独立的智力伙伴。参见常青笔记和卡片盒笔记法的异同点
实现常青笔记
参见：
参考文献
Ahrens, S. (2017).《如何做聪明的笔记：促进写作、学习和思考的简单技巧—面向学生、学者和非虚拟类书籍的作者》。
许多学生和学术写作者对待做笔记，就像一些古早的船东一样。他们处理想法和发现的办法，乍一看非常有道理：读到有趣的句子，就在句子下面划线。想发表什么意见，就写在空白处。突然冒出什么想法，就写在笔记本上，如果有篇文章看起来挺重要，就花点心思做做摘录。然而如此处理之后，各个地方都散落着大量笔记。那么写作就非常依赖大脑来记住笔记是什么时候，在哪里写下来的。
Luhmann, N. (1992). 与卡片盒的沟通。In A. Kieserling (Ed.), & M. Kuehn (Trans.),Universität als Milieu:Kleine Schriften(pp. 53-61). 检索自 http://luhmann.surge.sh/communicating-with-slip-boxes
up:: 🧰 本库使用指南
核心原则
\
像宪法一样不动摇地去遵守
- 闪念的捕捉记录，宁愿多做，不要不做。
- 做到库中80%的内容，都是自己手打输出的。
- 2025-07-05更新：AI时代，思路转变，可以且必须剪藏，让AI更方便提取上下文，参考AI 时代，剪藏不是为了稍后看，而是告诉 AI，我喜欢 by 玉伯
- 做到库中80%的笔记，经过自己的独立思考。
- 默认面对自己写笔记，不要考虑有读者。
- 奇技淫巧只为高频场景服务，很少用到的技巧忘了就忘了。
- 用间隔重复对抗遗忘，宁愿少忘记，不要多新学。
down:: ACCESS 笔记组织法
概括一下 LYT 笔记框架的核心内容
与 roamresearch 和 logseq 这种纯大纲，并且所有笔记文件只放在同一个文件夹下面不同，obsidian 有文件夹系统。那么 LYT 主张，文件夹分类和 MOC 结合使用的方式来组织笔记，并且借用 dataview 的强大 query 能力，将搜索结果保存下来。这几种方法相结合使用，让原子化笔记兼具结构性和流动性，更能实现常青笔记强调的，可被检索，可为未来服务的目的。综合来说就是教你如何通过 obsidian 构建自己的 PKM 系统。
obsidian、notion和logseq的异同分析及软件选用。
LYT 笔记框架是什么
linking your thinking的缩写。核心就是link。这个框架虽然强调文件夹、标签的作用，但第一公民依然是link链接，与其他双链笔记方法论一样，比如卡片盒笔记法 - Zettelkasten。
包含若干个部分：
- HOMEPAGE。即主页Home笔记。启动页屡见不鲜，电脑手机的开机界面，浏览器的启动页等等。此处作为自己的笔记库的一个启动入口。同时也是将整个笔记库联结成一张知识巨网的抓手。
- 各个∑ MOCs页面。其实就是一堆围绕某个特定主题的笔记的链接，放到同一则笔记里，并配上额外的文字说明提醒自己把这些笔记的内在逻辑串起来。
- 其他的流动式框架。给笔记加限定的结构，越发地被证明是一个很难坚持且无效的方式。但是如果我们创造一个框架，可以让这些限定的结构产生流动性，不是一成不变的，那么我们将兼得2个优势：秩序和混沌；结构化和灵活性，等等。
- 通过做笔记 note-making 而不是写笔记 note-taking，构建活笔记，如何做笔记 note-making。
- 使用ACCESS 笔记组织法。
- 强调用efforts而非projects思维，去发展自己的想法。
其他
up:: 🧰 本库使用指南
x: 本库使用时遵守的核心原则
设计哲学及理念
- 聚焦阅读、笔记与写作，不搞信息剪藏，不搞日程管理，不搞云上协同，不搞all in one。
- 链接优先。尽量让每一个文件都和其他文件有链接，文件大小可以小至原子化的一句话，也可大至一篇长文。
- 只使用markdown通行的标准语法+
[[语法，关注文本内容本身。尽量不用callout，尽量不用别名，尽量不用块引用，尽量不额外引入css搞排版和美化。- 更新，callout语法是微软也在用的markdown语法扩展，即使其他md平台不支持，顶多降级为引用格式，并且一定程度上丰富和美化了排版，所以我开始使用了。
- 开箱即用和渐进式掌握。本库可以开启安全模式以关闭全部第三方插件，依旧至少90%的功能可用，此为开箱即用。接着可以依次开启插件并配合∑ 本库 ACCESS 工作流汇总食用，渐进式掌握剩下的20%。我的理念遵循80%默认优先，20%深度定制。
- 统一快捷键、图标、命令行的对比与选择使用逻辑。只记超高频的快捷键，尽量通过命令行达到目的，少用图标点击。
- 如非必要，不搞定制。例如emoji和snippet均使用系统级输入方案，例如文本编辑快捷键和VSCode保持一致，例如定期git备份采用系统级定时任务，例如翻译采用系统级翻译软件。
- 沿用传统文件夹和标签笔记组织方式，让自己有安全感。使用现代∑ MOCs笔记组织方式，减轻结构化压力。参见obsidian组织笔记的5个要素和ACCESS 笔记组织法。
- 重器轻用，更详细的分析可见obsidian 不可回避的缺点及其解决方案。
- 目前obsidian的批量编辑和批量文件管理能力很弱，装了插件也是弱，所以用VSCode打开库进行。vscode这块儿能力已经相当成熟。
- 不搞任何iframe嵌入，因为iframe没有实质上的联动，本质上可完全被系统窗口管理能力更好地替代。
- 对于思维导图、epub和pdf阅读、音视频、图片等，obsidian相关插件没有独立软件好用。通过URL scheme和obsidian联动即可。
我用到的笔记方法论
up: ACCESS 笔记组织法
根据对obsidian的使用目标不同，分为3个层次，难度逐渐加大，因人而异。更多的层次划分，见obsidian的不同人的用法。
- 将obsidian的库作为一个卡片笔记盒。只使用obsidian进行每天的闪念记录，工作日志记录等。
- 使用» Daily notes工作流即可，只保留Calendar和Cards文件夹即可，其他文件夹通通删掉，用不到。
- 将obsidian做为一个∑ PKM系统。则此时还需要考虑各种文章、视频等各类信息和知识来源的消化处理回顾等问题。
- 各类不同载体的材料，通过Sources文件夹下的工作流进行处理。
- 各类行动导向且有预期完成时间的事儿，通过Spaces文件夹下的工作流进行归类与处理。
- 内容多了以后，需要将各种外置资源放置Extras文件夹，且通过Atlas下的MOC进行聚合。
- 关于待办处理和复习回顾见：» 我的标签使用工作流、» 我的复习回顾工作流。
- 将obsidian做为一个人生管理操作系统。朋友你可能发现了，本库只通过引入todo标签，进行简易的日程管理，也极力强调不要直接剪藏各种东西放到obsidian库里面来，尽量聚焦于∑ PKM。其他周边环节，我当前的判断是不适合在obsidian里面去做的，尽管有非常多极客般的朋友们实现了。
- 我的想法和做法将持续在∑ 工作和生活的效率体系建设更新。
一条主线：从闪念到任务、项目与回顾
如果只抓本库最常用的一条信息流，可以按下面这条主线理解：
- 闪念笔记 / daily note：先把想法、线索、问题抓住，不强求一次写完整。
- 这条笔记该去哪：判断它最终应该进入
Calendar、Cards、Spaces还是Sources。 - 问题单管理 / 项目笔记：需要持续推进的内容，从零散记录升级为任务或项目上下文。
- 计划与回顾：把执行结果和判断回收到回顾层，避免只记录不沉淀。
- 让Cursor将Cards中的笔记，针对某个主题进行有机串联，然后统一归入PARA / Obsidian CLI 快速入门（AI 可读版）：当主题成形后，再用双链和 AI 把散点内容编织成结构。