Obsidian vs DevScribe：知识管理 vs 工程执行

Source: Dev.to

如果你是一名开发者，可能已经使用过 Obsidian，或者至少考虑过它。
它速度快、以本地为先、基于 Markdown，且非常适合构建个人知识库。对于笔记、想法和文档，它表现出色。

但一旦你从思考软件转向实际构建，Obsidian 的局限性就会显现。这时 DevScribe 便登场了——它不是另一款笔记应用，而是一个完整的离线工程工作空间。本文将逐项对比 DevScribe 与 Obsidian 的功能，并解释为何它们实际上属于不同的类别。

核心身份

数据库支持（最大差异化）

DevScribe

• 原生支持真实数据库执行。
• 支持的数据库： MySQL、SQLite、PostgreSQL、MongoDB、Elasticsearch。
• 在文档中编写查询，存储查询及结果，维护模式定义，并在查询和文档旁可视化模式。
• 不需要 DBeaver 或 DataGrip 等外部工具。

Obsidian

• 没有原生数据库执行。
• 可通过插件实现，但大多为只读，且工作流手动且未集成。
• 没有与数据库绑定的实时模式可视化。

获胜者： DevScribe（优势明显）

图表绘制

DevScribe

• 专为软件设计而构建的图表绘制工具。
• 支持的图表： ERD、HLD、LLD、类图、时序图、数据结构图。
• 图表与代码、API 和数据库查询并存，使其在设计评审、架构文档和系统入职培训中非常有用。

Obsidian Canvas

• 非常适合概念图、头脑风暴和可视化笔记。
• 不适用于与实际系统关联的 ERD、UML 或时序图。

获胜者： DevScribe，适用于工程场景

API 测试

DevScribe

• 包含类似 Postman 的 API 界面。
• 在文档中运行和测试 API，定义请求，检查响应，并将 API 文档、测试和示例放在一起。
• API 可以嵌入单个文档中，或按端点拆分为多个文件。

Obsidian

• 没有原生的 API 测试功能。
• API 只能以 Markdown 形式记录，并需要使用外部工具，如 Postman 或 Insomnia。

Winner: DevScribe

项目结构

DevScribe 复制真实的项目结构：

• 📄 API 定义 → 单独文件
• 📄 文档 → 单独文件
• 📊 图表 → 单独文件
• 🗄️ 数据库查询和模式 → 单独文件

或者如果你愿意，所有内容也可以放在一个合并文档中。这在长期项目、团队入职和架构评审时尤其有效。

Obsidian 提供基于 Markdown 的 vault，擅长自由形式的笔记，对工程制品的限制更少。

Winner: DevScribe 用于基于项目的开发

功能比较

权衡：

• Obsidian: 灵活性
• DevScribe: 深度 + 集成

理想用户画像

如果你符合以下情况，请选择 DevScribe：

• 设计系统（高层设计 / 低层设计）
• 每天编写和运行数据库查询
• 定期测试 API
• 想要在同一处拥有文档、图表、API 和数据库
• 讨厌在 5–6 个工具之间切换

如果你符合以下情况，请选择 Obsidian：

• 构建个人知识库
• 编写长篇笔记或进行研究
• 偏好 Markdown + 插件
• 不需要执行（API / 数据库）

战略定位概述

• Obsidian: “第二大脑，用于思考和写作。”
• DevScribe: “本地工程工作区，文档可执行。”

最后思考

如果你的工作流程仅止于写笔记，Obsidian 非常出色。
但如果你的工作涉及数据库、API、图表以及实际执行，你需要的不仅仅是笔记。这正是 DevScribe 的定位——也是它存在的原因。