SoloMD：把 Markdown 笔记接入本地 AI 工作流

它解决什么问题

SoloMD 把 Markdown 文件夹作为知识库，并在编辑器内提供 AI 入口，同时通过内置的 solomd-mcp 让外部 MCP 客户端访问同一工作区。它适合希望继续保留纯文本文件、又想让 Claude Code、Cursor 或其他 MCP 客户端参与整理和改写的人。项目采用 MIT 许可证，仓库目前未归档。

已知功能

编辑器部分包含所见即所得编辑、标签页与分栏、KaTeX、Mermaid、图片粘贴到 _assets/、幻灯片模式、Vim 模式、Hunspell 与 CJK 校对、语义搜索、wikilinks、反向链接及 Pandoc 导出。README 还列出了 GBK、Big5 和 Shift-JIS 的自动检测。

知识库功能包括 YAML frontmatter 属性检查器、按类型组织的侧栏、带类型的关系、单条笔记的关系图、可保存的筛选视图，以及基于 Markdown 的 tldraw 白板。对重视文件可读性和可迁移性的用户，这些功能值得重点检查其实际文件格式与工作流影响。

AI 侧包含 Agent Panel、可用 YAML 描述的定时或事件触发配方，以及 AutoGit 分支沙箱。README 称代理写入会先进入独立分支，并提供接受或拒绝流程；运行过程还会生成可回放的 trace。MCP 服务默认只读，启用写入需要额外选择。项目同时声称支持 14 个 AI 提供商和 BYOK，但具体供应商行为、费用和数据处理政策仍应分别核对。

适合谁

它适合已经使用 Markdown 知识库、希望在本地文件之上加入 AI 整理能力的个人用户、研究者、写作者和开发者。熟悉 Git、MCP 或 YAML 的用户更容易理解同步、代理配方和工作区权限。若只需要极简 Markdown 编辑，代理、图谱和集成层可能会增加学习与维护成本。

采用前的限制

首先，AI 功能并不等于离线运行。README 列出 Ollama 本地提供商，也列出多个云端提供商；实际是否离开设备取决于配置、模型和调用路径。不要把“本地优先”理解为所有 AI 请求都不会联网。BYOK 也意味着用户需要自行管理供应商账户、密钥和费用。

其次，自动化写入应先在副本或测试工作区验证。虽然来源描述了分支、写入上限和脏工作树检查，但这不能替代备份、版本审阅和供应商输出核验。涉及隐私、版权或高风险决策的内容，不应仅依赖代理结果。

最后，平台支持与发行状态要分开看。README 列出多个系统版本，v4.14.8 release 提供对应安装包说明；但 Windows 构建尚未代码签名，首次运行可能遇到系统提示。来源未确认所有平台的功能一致性、最低硬件配置或长期移动端体验。

部署考虑

部署前应确认工作区路径、备份策略、Git 仓库权限和 AI 提供商的数据政策。若接入 MCP，按最小权限原则只暴露必要的工作区，并先保持只读；需要写入时，应审阅每次变更。若使用 GitHub 同步或其他 HTTPS Git 服务，还需单独评估仓库可见性、密钥保管和冲突处理。Windows 用户应通过 release 附件和校验文件核对下载；官方 release 提供 SHA256SUMS.txt 供自行验证。本文未对项目进行实测，也未独立验证其安全性或性能。

资料来源

• GitHub repository metadata
• Project README
• Official release
• Official project page

资料核对日期：2026-10-06