DaoBox 是一个本地 Markdown 文件知识库。
你的笔记和资料，都保存在自己电脑上的一个文件夹里。
在这里，你可以写、整理、搜索、关联和阅读自己的知识；Markdown 是主要内容形式，同时也可以和图片、PDF、HTML、音视频等文件放在一起。
最重要的是：
你的知识，就是你的文件。
这些内容不会被锁在某个 App 的数据库里。你可以随时备份、复制、迁移，也可以用其他工具打开。
DaoBox 做的，是让这些原本就属于你的文件，更适合长期积累、整理和使用。
1. 一个文件夹，就是一个知识库
使用 DaoBox，不需要先建立一个特殊的数据库。
打开一个文件夹，它就可以成为你的知识库。
你可以按照自己的习惯建立目录：
我的知识库/
├── 阅读/
├── 工作/
├── 编程/
├── 想法/
├── 项目/
└── ...
里面就是普通文件。
Markdown 笔记、图片、PDF、HTML 页面以及其他资料，都可以按照自己的方式组织。
这意味着你的知识库从一开始就是开放的：
- 可以直接在 Finder / 文件管理器里看到；
- 可以复制整个文件夹进行备份；
- 可以换电脑后继续使用；
- 可以用其他 Markdown 编辑器打开；
- 可以交给 Git 管理；
- 不依赖 DaoBox 才能读取自己的内容。
所以 DaoBox 更像是在你的文件之上，提供了一套完整的知识工作方式。
文件属于你，知识也属于你。
2. 为什么选择本地文件
很多笔记软件会把内容存进自己的数据库。
这样做当然可以带来很多便利，但也意味着：
你的知识开始依赖这个软件本身。
一旦软件停止维护、数据格式改变，或者你想换一个工具，就可能需要考虑数据迁移。
DaoBox 选择另一条路：
让最重要的东西保持简单。
Markdown 本身就是一种开放、轻量、长期可读的文本格式。
你的知识不需要藏在 DaoBox 里面。
DaoBox 可以消失，但你的文件仍然在那里。
这也是 DaoBox 最重要的设计原则之一：
应用可以更换，文件不应该被绑架。
3. 它不只是一个 Markdown 编辑器
如果只是编辑 Markdown，一个普通编辑器已经足够。
DaoBox 更关注的是：
当 Markdown 文件越来越多之后，如何把它们真正用起来。
因此，它提供的是围绕知识库的一整套能力：
- 文件夹组织；
- Markdown 阅读与编辑；
- 全文搜索；
- 大纲；
- 标签；
- 双向链接；
- 反向引用；
- 本地资源；
- 文件预览；
- Git 版本管理。
你可以把一篇笔记当成一篇独立的文档，也可以把很多笔记连接起来，逐渐形成自己的知识网络。
文件越积越多，知识库也可以慢慢长出来。
4. 阅读和编辑，不必一直处于同一种状态
DaoBox 不要求你时时刻刻都处于“编辑器模式”。
大多数时候，你其实是在：
- 阅读；
- 查找；
- 浏览；
- 整理；
- 思考。
只有真正需要修改的时候，才进入编辑。
因此 Markdown 在 DaoBox 中更偏向于：
平时好好阅读，需要修改时再编辑。
编辑时也尽量避免因为 Markdown 语法的出现、隐藏和变化，让页面不断跳动。
你看到的内容和最终呈现出来的内容，应该保持清楚、稳定的关系。
5. 一篇内容，可以同时写给自己和别人
这是 DaoBox 很重要的一种使用方式。
写一篇文章的时候，你可能会同时产生两类内容：
准备公开的：
已经整理好的观点、正文、资料和结论。
暂时只想留给自己的：
没想清楚的判断、真实想法、备注、碎片化思考。
传统的做法通常是：
- 写两份文件；
- 发布前手动删除；
- 或者依赖插件解决。
DaoBox 希望这件事情简单一些。
你可以在同一份 Markdown 中，把某些内容标记为私有。
这些内容：
- 在自己的知识库中仍然存在；
- 自己可以继续查看；
- 可以作为自己的上下文使用；
- 发布时自动对读者隐藏。
于是，一篇内容不需要为了“公开”而先把自己删干净。
同一份内容，可以同时服务于自己和读者。
6. 知识不需要一开始就决定用途
很多时候，你并不知道今天写下的一段东西，半年以后会不会变成一篇文章。
所以 DaoBox 不要求你一开始就做决定。
可以只是：
先记下来。
然后：
慢慢整理。
再然后：
建立关联。
等到某一天，你觉得这些内容已经足够成熟，再决定：
要不要把它分享出去。
这也是 DaoBox 和传统“写博客工具”最大的区别之一。
发布不是写作的起点。
发布只是知识积累之后的一种输出方式。
7. 同一批文件，也可以交给别人
当你真的想把知识分享出去时，不需要重新建立一个内容系统。
轻量一点：可以把单篇 Markdown 导出为 PDF / Word，或 单篇分享到网上 给人看。
更完整时：DaoBox 可以直接使用当前知识库中的内容进行预览和发布成站点。
也就是说：
本地文件
↓
知识库
↓
整理 / 关联 / 完善
↓
导出单篇 / 站点预览
↓
交给别人 / 发布
过程中没有必要复制出第二份内容。
同一批 Markdown 文件，可以根据不同的模板呈现成不同形式，例如：
- 博客；
- 书籍式知识库；
- 文档站；
- 其他适合内容展示的站点形式。
对于普通用户来说，不需要先学习模板系统、命令行或者复杂的部署流程。
写的时候只管内容，需要的时候再决定怎么交给别人。
8. 文件本身，也可以直接被阅读
DaoBox 的知识库并不要求所有东西最终都变成 Markdown。
一个知识库本来就可能包含很多不同类型的资料。
例如：
知识库/
├── Markdown 笔记
├── 图片
├── PDF
├── HTML
├── 音频
└── 视频
DaoBox 会根据文件类型使用合适的方式打开：
- Markdown → 阅读与编辑；
- HTML → 直接作为网页查看；
- 图片 → 图片预览；
- 音频 → 音频播放；
- 视频 → 视频播放；
- PDF → PDF 查看；
- 其他文件 → 使用相应的文件查看或编辑方式。
所以你不需要为了使用知识库，而把所有资料都转换成同一种格式。
文件是什么，就尽量用适合它的方式打开。
9. Git，让知识可以回到过去
知识库不是静态的。
今天修改的内容，可能明天觉得不对；几个月前的一版文章，也可能值得重新找回来。
DaoBox 将 Git 的版本能力融入知识库，让你可以在应用内完成常见的版本操作：
- 查看修改；
- 提交版本；
- 查看历史；
- 恢复过去的内容；
- 与远程仓库同步；
- 从远程仓库克隆知识库。
你不需要为了管理自己的知识，先学会一套复杂的命令行操作。
但底层依然是成熟的 Git。
因此：
知识可以不断变化，但不会轻易丢掉来路。
10. DaoBox 适合怎样的人
DaoBox 更适合这些情况：
长期积累知识
你有很多 Markdown 笔记，希望它们始终以自己的文件形式存在，并随着时间慢慢形成一个完整的知识库。
不想被某个笔记软件绑定
你希望文件可以自由备份、迁移，也希望未来可以换工具，而不是把多年积累锁在某个 App 中。
写东西时经常需要先留给自己
你写文章、做研究、整理资料时，会产生很多暂时不能公开的内容，希望它们和最终内容自然地存在于一起。
偶尔需要把知识分享出去
你平时主要是在积累知识，并不需要每天写博客，但某些内容成熟之后，希望能导出给别人，或自然地变成一个网站。
希望一个工具覆盖从积累到输出
不想为了写笔记使用一个工具，为了导出或发布再学习另一套工具链。
11. DaoBox 不是什么
DaoBox 不是试图替代所有工具的“大而全”知识管理系统。
它也不是要求你改变工作方式的一套封闭生态。
它更希望保持一件事情简单：
你的文件仍然是你的文件。
DaoBox 只是在这些文件之上，提供更好的阅读、编辑、整理、关联、版本管理和发布能力。
你可以只把它当作本地知识库使用。
也可以进一步使用导出、单篇分享与站点发布能力。
不需要为了使用某一个功能，而改变整个知识库的组织方式。
12. 最后
知识不是一次整理完成的东西。
它通常只是从一个文件、一段文字、一个想法开始。
今天随手记下来的东西，可能几个月后变成一篇文章；一篇文章又可能成为一本书的一部分；很多零散的笔记，也可能慢慢连接成一个真正属于自己的知识体系。
DaoBox 想做的，就是让这条路尽量自然：
先留下来。 再慢慢整理。 需要的时候，再把它交给别人。
而从始至终：
你的知识，就是你的文件。