SoloMD 评测：本地优先的 Markdown 编辑器，把 Claude Code 变成你的笔记助手

一个编辑器，两个入口：本地编辑与 AI 代理

SoloMD 解决的核心问题是：当你的笔记散落在本地 Markdown 文件夹里，如何让 AI 代理像你一样直接读写这些文件。大多数编辑器要么只提供聊天界面，要么需要你把内容导出到云端。SoloMD 的定位是“编辑器之上的代理界面”，它同时提供两个入口：一个传统的手动编辑界面，另一个是内置的 MCP 服务器，让 Claude Code、Cursor 等客户端从外部驱动你的笔记库。这种设计意味着你不需要把笔记迁移到某个专有格式，.md 文件就是你的数据源，AI 代理只是另一个读写者。

MCP 服务器：无端口、无网络监听，只有文件路径

SoloMD 的 MCP 服务器是独立于主应用的 crate，位于 mcp-server/ 目录。它通过 stdio 与 AI 客户端通信，这意味着它不监听任何网络端口。根据 README 的描述，它进行了路径遍历保护，LLM 只能看到你通过 --workspace 参数指定的文件夹。你可以通过 solomd mcp-config 命令生成配置片段，粘贴到 Claude Desktop 或 Cursor 中。配置的核心是 command 指向应用内的 solomd-mcp 可执行文件，args 指定 workspace 路径。对于多 vault 场景，你可以重复 --workspace 参数，让一个 MCP 服务器同时管理多个文件夹。这个设计比常见的 HTTP 服务器更安全，因为它没有暴露网络接口，但你需要自己理解 stdio 通信的局限性：AI 客户端必须与 MCP 服务器在同一台机器上运行。

安装与构建：从 brew 到源码，五条路

安装 SoloMD 有多种方式，取决于你的平台。macOS 用户可以用 brew install --cask zhitongblog/solomd/solomd，或直接下载 dmg。Windows 用户有 msi 安装包和便携版 zip，也可以用 winget install solomd。Linux 用户有 AppImage、deb、rpm 包，Arch 用户可以通过 AUR 的 solomd-bin 安装。如果你想从源码构建，README 给出了明确步骤：git clone 仓库，进入 app 目录，运行 pnpm install 和 pnpm tauri dev。注意 Linux 需要额外安装 libdbus-1-dev 用于 keychain 后端。MCP 服务器是独立的 crate，位于 mcp-server/，这意味着你可以只使用 MCP 服务器而不安装完整编辑器，只要你的系统能运行那个可执行文件。

知识图谱层：从纯文本到结构化笔记的跳跃

SoloMD 4.6 版本引入了知识图谱层，这是它区别于普通 Markdown 编辑器的关键。属性检查器（⌘⇧I）允许你编辑 YAML frontmatter，并且声称是“行级精确写入”，保留注释、内联数组和引号的原样字节。这意味着它不像某些工具那样重写整个文件，而是只修改你改动的行。类型驱动的侧边栏让你给笔记设置 type: Project，然后该类型的笔记会以自定义图标、颜色和列显示。关系字段如 belongs_to、related_to、has 会自动生成反向链接，并在服务器端解析，以应对大型 vault。这些功能本质上是在 Markdown 文件之上叠加了一层结构，但数据仍然以 plain text 保存，没有专有数据库。这种设计的代价是，当你的 frontmatter 变得复杂时，手动编辑原始文件的体验可能会与图形界面产生冲突，你需要信任它的行级写入确实不会破坏格式。

CLI 与自动化：定时任务和命令行代理

除了图形界面，SoloMD 还提供了 CLI 接口。你可以运行 solomd agent "rewrite this week of dailies into a weekly review and commit it"，直接向命令行代理发出指令。README 还提到“计划配方”（scheduled recipes），可以在你不在键盘前时运行。这意味着 SoloMD 不仅是编辑器，还是一个自动化工具。但请注意，这些功能的具体配置方式在 README 中并未详细展开，只给出了一个 agent 命令的示例。如果你需要复杂的自动化流程，可能需要查阅文档或源码。CLI 的存在让 SoloMD 可以集成到脚本中，例如配合 cron 或 CI 系统，但你需要确认这些命令在非交互环境下的行为是否符合预期。

局限与失败模式：Windows 7 不支持，依赖 WebView2

SoloMD 明确不支持 Windows 7、8、8.1。原因有两个：Rust 工具链自 1.78 版本起要求 Windows 10，而且微软冻结了 WebView2 在 Windows 7 上的版本（109），没有安全更新。这意味着如果你还在使用旧 Windows 系统，SoloMD 不是你的选择，而且没有遗留构建可用。另一个潜在问题是，MCP 服务器通过 stdio 通信，这要求 AI 客户端必须与服务器在同一台机器上运行，如果你希望通过网络远程控制笔记库，这个设计就不适用。路径遍历保护听起来安全，但 README 没有详细说明保护的实现方式，你需要自行验证它是否覆盖所有边界情况，特别是符号链接或路径规范化问题。

替代方案：Obsidian 和 Tolaria 的对比

README 提到与 Obsidian、Typora、Tolaria 的对比，但只给出了链接。从结构上看，Obsidian 是更成熟的笔记应用，有庞大的插件生态，但它的核心是闭源的，AI 集成通常依赖第三方插件或外部服务。Tolaria 据 README 描述，与 SoloMD 在 tldraw 白板格式上兼容，这意味着两者都使用 Markdown 中的 ```tldraw 代码围栏来存储白板数据。SoloMD 的优势在于它原生内置 MCP 服务器，而 Obsidian 需要你手动配置类似插件。如果你已经深度使用 Obsidian 的插件系统，迁移到 SoloMD 可能需要放弃那些插件。Typora 则是一个纯粹的美观编辑器，没有代理集成。所以，如果你需要 AI 代理直接操作笔记，SoloMD 的 MCP 服务器是开箱即用的，而其他工具可能需要额外搭建。

维护与许可：MIT 与单一维护者的现实

SoloMD 采用 MIT 许可证，这意味着你可以自由使用、修改甚至分发，没有订阅费用。仓库显示最近提交频繁，v4.11.20 在 2026 年 8 月 29 日发布，看起来活跃。但 README 的“联系”部分明确写着“One maintainer, two front doors”，这是一个单一维护者的项目。这带来一个现实问题：如果维护者停止工作，你的使用不会受影响（因为代码是 MIT），但你可能需要自己修复 bug 或等待社区 fork。升级成本方面，Tauri 2 和 Vue 3 的架构意味着更新可能涉及 Rust 和前端依赖，如果你从源码构建，需要处理 pnpm 和 Rust 工具链的版本兼容性。对于普通用户，通过 brew 或 winget 安装的版本更新应该相对顺利，但如果你依赖 CLI 或 MCP 服务器的特定行为，升级前需要检查 changelog。

编辑结论

SoloMD 适合那些已经用 Markdown 管理笔记、并且希望让 AI 代理直接读写本地文件的技术用户。它不适合需要云端同步或多人协作的团队，也不适合对 Windows 7 等旧系统有依赖的用户。在采用前，你应该先验证 MCP 服务器的路径保护是否符合你的安全预期，用 solomd mcp-config 生成配置并测试一个非敏感文件夹，再决定是否将整个 vault 暴露给 AI 客户端。它的 MIT 许可证和本地存储意味着没有供应商锁定，但你要自己承担备份和版本控制的责任。

官方来源

1. Official documentation
2. Official README
3. Project repository
4. Release notes