1. 办公妙招：介绍一款优秀的本地优先Markdown笔记工具-SoloMD

1.1 业务场景

技术文档与代码协作：API 文档、README、开发规范，Git 平台原生渲染，是程序员的通用语言。
知识管理与笔记：个人知识库、学习笔记、每日记录，纯文本 .md 永不过时、可本地检索。
内容写作与发布：博客、公众号、技术文章、电子书，专注内容本身，写完一键导出多格式。
办公与教学协作：会议纪要、需求文档、课程讲义、报告，用表格/列表/公式高效排版。
数据轻量记录：表格数据、任务清单、项目进度，比 Excel 轻、比纯文本结构清晰。

1.2 用户痛点

1.2.1 几个突出的问题

Typora等：收费
Obsidian等：体型巨大、打开缓慢，用户只是想简单的写个Markdown，需要安装几百M的软件。
众多平替：功能残缺不全、使用不顺手

1.2.2 主流的Markdown编辑器横向比较

维度	Typora	Obsidian	VNote	SoloMD	MarkText	Zettlr
定位	写作 / 成稿	知识库	程序员笔记	AI 优先写作	极简写作	学术写作
安装包	~80 MB	~94 MB	~103--160 MB（便携免安装）	~10--15 MB	~90 MB	~121 MB
安装后空间	~350 MB	~293--350 MB	~684 MB（含 Qt 运行时）	~65--80 MB	~300 MB	~350 MB
运行内存	200--260 MB / 多标签 300+ MB	250--500 MB，插件下可破 2 GB	100--200 MB	80--150 MB	150--250 MB	200--350 MB
所见即所得	✅ 标杆级单栏实时渲染	⚠️ 需切"实时预览"，源码/阅读分离	✅语法高亮式原位预览	✅ Typora 风格	✅ 输入即渲染	⚠️ 单/双/三栏可切换
表格编辑器	✅ 可视化增删行列、拖拽排序、Tab 跳转	⚠️ 核心无 GUI，需 Advanced Tables 插件	✅ 内置可视化编辑	✅ 内置可视化编辑	✅ 拖拽调行列、支持合并	✅ Ctrl+T 插入，Pandoc 驱动
导出 HTML	✅ 原生	✅ 需 Pandoc 插件	✅ 原生	✅ Pandoc	✅ 原生	✅ 原生
导出 PDF	✅ 原生（可自定义页边距、字体）	✅ 核心支持	✅ 原生	✅ Pandoc	✅ 原生	✅ LaTeX 引擎，学术排版最强
导出其他	Word / LaTeX / ePub / OpenOffice	Word / LaTeX / ePub（插件）	Word（需配置）	docx / txt（MCP export_note）	有限	DOCX / LaTeX / ODT / EPUB / PDF 管线最完整
本地优先	✅ 纯 .md 文件	✅ vault 即普通文件夹	✅ 纯文本，笔记本=文件夹	✅ 文件留在本地，无自建服务器	✅ 本地文件	✅ 本地文件，无强制云
跨设备同步	❌ 无内置，靠 iCloud / OneDrive / Dropbox / 坚果云 / Syncthing / Git	✅ 官方 Sync（$4/月起，端到端加密）；亦支持 iCloud / Git / Syncthing	⚠️ 无内置；可配坚果云 WebDAV；V4 后称将支持 Git / WebDAV / OneDrive	✅ iCloud / Dropbox / OneDrive / Syncthing；GitHub AutoGit；CRDT 内置同步在路线图	✅ v1.6.1 起内置 WebDAV + Git 双通道，可同步坚果云、NextCloud	⚠️ 无内置，用 iCloud / Git / 任意文件同步服务
WebDAV	❌ 官方不支持	❌ 核心不支持，需 Remotely Save / Cloud Sync 第三方插件	⚠️ 官方计划支持（V4 后），目前靠坚果云等客户端中转	✅5.0.5支持	✅ v1.6.1（2026-10-16）原生支持	❌
AI 支持	❌ 无原生 AI	✅ 插件生态（Copilot、Smart Second Brain）	❌ 无	✅ 核心卖点：Agent 面板 + 14 家 BYOK + AutoGit 分支沙箱 + 可重放 Trace	❌ 无	⚠️ 有 AI 辅助插件，生态弱于 Obsidian
技术栈	Electron	Electron / Capacitor	C++ / Qt（原生最轻）	Tauri 2 / Rust / Vue 3	Electron	Electron
授权	付费买断（$14.99，可试用）	个人免费 / 商业 $50/年	开源免费（MIT）	开源免费（MIT）	开源免费（MIT）	开源免费（GPLv3）
🔹 Windows	✅ Win 10/11，x86 / amd64 / ARM64 全架构	✅ 通用包（含 x86 / arm64）	✅	✅ x64 + ARM64（Snapdragon X / Copilot+ PC 官方包）	✅ Win 10/11，x64 + arm64	✅ Win 10+，64 位 + ARM64
🔹 macOS	✅ ≥ 11.0，原生支持 Apple Silicon + Intel	✅ Universal（Apple Silicon + Intel）	✅	✅ Universal DMG（Apple Silicon + Intel，已签名公证）+ brew install --cask	✅ 11 Big Sur+，x64 + arm64	✅ 12.0+，Intel + Apple Silicon
🔹 Linux	✅ 测试于 Ubuntu 18.04/20.04，x64 + arm64	✅ Snap / AppImage / Flatpak	✅	✅ x86_64 + aarch64：.AppImage / .deb / .rpm / AUR solomd-bin	✅ x64：.deb / .rpm / .snap / .tar.gz / AUR	✅ 64 位 + ARM64：.deb / .rpm / AppImage / Flatpak / APT 仓库
🔹 Android	❌ 无官方客户端	✅ Play 商店 / APK	❌	✅ APK + Google Play 封闭测试，原生 Android UI	❌ 桌面应用	⚠️ 官网标注支持，但官方下载页未提供独立 APK，需通过第三方
🔹 iOS / iPadOS	❌ 无官方客户端	✅ App Store	❌	✅ App Store 原生，iPad 同引擎	❌ 桌面应用	❌
🔹 鸿蒙（HarmonyOS）	❌	❌	❌	❌	❌	❌
🔹 架构覆盖总结	桌面端三平台全架构	桌面三平台 + 移动双端	仅桌面三平台	五平台最广，含 ARM64 / aarch64 全系	桌面三平台	桌面三平台 + 移动弱支持
🔹 安装方式	exe / dmg / deb	exe / dmg / Snap / Flatpak / APK / App Store	exe / dmg / AppImage / AUR / Homebrew	exe / msi / dmg / AppImage / deb / rpm / AUR / APK / App Store / winget / curl 一键脚本	exe / zip / dmg / deb / rpm / snap / tar.gz / AUR	exe / dmg / MSI / deb / rpm / AppImage / Flatpak / winget / choco / brew / APT

1.3 SoloMD功能介绍

⚠注意:

本文只对SoloMD的基本功能进行介绍，具体功能的深入介绍由相关专题文章单独介绍。

本文基于SoloMD 5.0.13版本，由于SoloMD的更新还非常活跃，本文介绍的部分内容由于软件更新，可能变得不再适用。

本文基于Windows平台版本进行介绍，其他平台的功能与此类似，但不具体进行介绍。

1.3.1 功能特色

1.3.1.1 核心编辑：所见即所得

• 实时预览：光标离开当前行，Markdown 标记符号自动隐藏；标题真大、粗体真粗、代码真等宽，无工具栏干扰

• 四种视图一键切换：实时 / 源码 / 分栏 / 预览；分栏左右按行同步滚动

• 选中即排版：选中一段文字，加粗、链接、标题、引用浮现在选区旁，无需记快捷键

• 文件树 + 大纲 + ripgrep 式全局搜索；多标签带脏标识；会话恢复，关闭前最后输入的文字不丢失

用法：打开文件夹即进入 vault；Ctrl+Shift+K 命令面板，Ctrl+Shift+F 全局搜索，Ctrl+H 查找替换（支持正则）。

1.3.1.2 Markdown 增强渲染

• KaTeX 数学公式（E=mc^2 行内与块级实时渲染）

• Mermaid 图表：流程图、序列图、甘特图，点击可放大

• 代码块语法高亮（13+ 种语言）、脚注、YAML front-matter、高亮、可点击任务列表 checkbox

• 图片粘贴自动存入 _assets/；CJK 编码自动识别（UTF-8 / GBK / Big5 / Shift-JIS，老文件也能正确打开）

• 8 套主题（浅色/深色/跟随系统）、自定义 CSS、行号折叠标题

用法：直接按 Markdown 语法写，渲染即时生效；图片粘贴即自动落盘。

1.3.1.3 写作者工具

• 焦点模式（非当前段落自动变暗）+ 打字机模式（光标垂直居中）

• 简繁转换、拼音、CJK 字数统计

• Hunspell + CJK 校对、拼写检查

• 演讲模式（Cmd+Alt+P 把 .md 渲染为全屏幻灯片）

• 每日笔记、字数胶囊

用法：菜单或命令面板切换模式，写作时全程不被打断。

1.3.1.4 导出

• Pandoc 驱动：PDF / DOCX / EPUB / ODT / LaTeX

• 导出时 KaTeX、Mermaid 直接烘焙进成品

• 复制为 HTML / 纯文本 / Markdown；可导出 Word（粗体、有序列表、任务列表、链接均可还原，任务项带 ☐/☑）

用法：写完在命令面板或菜单执行导出，不用离开编辑器。

1.3.1.5 知识管理：双向链接 + 知识图谱

• Wikilinks + 反向链接面板，无臃肿的关系图谱视图

• 类型驱动侧栏：给笔记设 type，其成员成为可折叠的一等公民区块

• 自动反向链接 + 关系图（Neighborhood），可探索每条笔记的关联邻域

• 保存的筛选视图：.solomd/views/*.yml，支持递归的 all/any 过滤器（类型/状态/日期/正则）

• 收件箱工作流：Cmd+E 标记已整理 + 自动跳下一条，直达 inbox-zero

• @citekey 引用通过 Pandoc 端到端保留

用法：用笔记名建立链接，侧栏自动显示反链；YAML front-matter 定义类型与关系。

1.3.1.6 本地语义搜索（Local RAG）

• 按"意思"而不是关键词在整个 vault 里排序段落（搜"部署"能找出讲"发版""上线"的段落）

• 完全本地运行：Rust 进程内的哈希字符三元组嵌入器，不下载模型、不联网，索引存 /.solomd/embeddings.sqlite

• 默认关闭，开启前不扫描、不建索引

用法：Cmd+Shift+F 打开搜索面板，切到"语义"模式。

1.3.1.7 AI 改写：14 家 BYOK

• 支持 OpenAI / Claude / Gemini / xAI / Mistral / Groq / DeepSeek / Qwen / GLM / Kimi / Doubao / SiliconFlow / OpenRouter / Ollama

• Key 存系统钥匙串（macOS Keychain / Windows 凭据管理器 / Linux libsecret），不落盘明文；直连厂商，无 SoloMD 中转，只发送选中文字

• Ollama 自动检测（默认 localhost:11434，三档预设 qwen2.5:1.5b/7b/14b），可零云成本自治循环

用法：选中文字按 Ctrl+J 即触发改写。

1.3.1.8 Agent 面板（v4.0，编辑器的"第三半"）

• 右侧一等公民面板，流式 chat-with-vault

• 引用自动解析为 wikilink 跳转芯片；工具调用以卡片内联展开；回复有 Insert / Copy 按钮直接塞回当前笔记

• 运行历史以纯 Markdown 存于 .solomd/agent-runs/，可随时查阅

• 配套 solomd agent CLI：把任务交给 Claude Code / Codex CLI，MCP 已预连

用法：Cmd+Shift+A 打开面板，直接问"我这周记了哪些关于 X 的想法"。

1.3.1.9 定时 Recipe：可编程自动化

• 声明式 YAML 文件，放在 /.solomd/agents/*.yml

• 触发器：cron / on-save / on-commit / on-tag-add / manual

• AutoGit 分支沙箱：每次写入落在独立分支，你 accept / reject 后才合入 main

• 单次写上限默认 5（上限 50）、工作区 dirty 时拒绝启动、每步生成可重放的 trace.jsonl

用法：写一个 YAML，设定触发条件，Agent 不在键盘前也能自动跑。

1.3.1.10 AutoGit 版本历史

• 每次 Cmd+S 在 workspace 内做本地 .git 提交，libgit2 内置，无需装 git、永不自动 push

• 侧栏 History 面板列出版本，一键回滚

用法：正常保存即自动建档，误删或写坏随时回退。

1.3.1.11 内置 MCP Server

• 1.5 MB 二进制 solomd-mcp，把 vault 暴露给 Claude Desktop / Cursor / Codex CLI 等任意 MCP 客户端

• 开箱 13 个工具（8 通用 + 5 个 SoloMD 独有：autogit_log / autogit_diff / autogit_rollback / sync_status / share_url）

• stdio 协议，不开网络端口，默认只读；--allow-write 显式开启写工具；路径参数做规范化 + 穿越防护

• v4.0 起支持 --workspace 多 vault 联邦，一个会话管多个仓库

用法：在 MCP 客户端配置指向 solomd-mcp 可执行文件 + workspace 路径。

1.3.1.12 跨设备同步

• iCloud / Dropbox / OneDrive / Syncthing 等任意文件同步服务

• GitHub 后端同步：每次保存推送到私有仓库，可选端到端加密（Argon2id + XChaCha20-Poly1305）；GitLab / Gitea / 任意 HTTPS git URL 也可用

• 内置 CRDT 同步在路线图中

用法：把 vault 放进 iCloud 文件夹，或用官方 GitHub 同步开关。

1.3.1.13 平台与安装

• Windows / macOS / Linux（x64 + ARM64）/ Android（API 24+）/ iOS（15+）五平台

• 安装包约 15 MB（Mac universal DMG 约 32 MB）；空闲内存 80--150 MB；15 种界面语言

• 安装方式：curl -fsSL https://solomd.app/install.sh | bash / PowerShell 一键脚本 / winget / brew / scoop / choco / apt / AUR / solomd open/new/list/search CLI

需要我把这份功能清单整理成一份带截图位的官方风格产品说明文档，或者导出成可交互的 HTML 功能导航页吗？

1.3.2 基础功能

1.3.2.1 界面介绍

传统的分栏式编辑器，由于编辑区域部分一分为二，导致要么编辑区被挤压，要么预览区域被挤压，需要反复调整，使用体验并不好。
相对于传统的分栏式Markdown编辑器，SoloMD提供了实时模式，该模式近乎所见所得的编辑效果，在一个视图中即可完成几乎全部的Markdown编辑工作。
SoloMD的主界面：

1.3.2.2 书写模式

实时模式
推荐：实时模式几乎是一种所见所得的模式，标题、加粗、斜体等格式都会实时渲染，但同时也会保留格式符标记，实时模式下图片会实时显示。

⚠注意 :

目前实时模式下的表格、mermaid图表还没有实时显示(相关功能正在快速迭代中)。

源码模式

源码模式下只有Markdown的原始代码，标题、文字格式、图片都不会进行渲染，但会有Markdown的语法着色。
分栏模式

书写窗口分为两栏，左侧为源码编辑，右侧为实时渲染窗口，方便一边写一边查阅最终结果。

使用分栏模式好处很明显，可以实时查阅结果，但缺点也很明显，书写窗口被压缩了一半。
预览模式

预览模式方便使用源码模式的用户，偶尔切换查看最终的笔记渲染效果，建议设置快捷键来回切换。

除了使用预览模式，还可以使用阅读模式，但阅读模式会切换到全屏，用户可以根据自己的喜好使用两种方式之一。

1.3.2.3 格式设置

Markdown标准的语法大部分都能支持快捷键，快速设置，比如：Ctrl+B加粗等。

⚠注意 :

需要注意的是，Ctrl+B快捷键使用习惯，需要在设置中进行调整，在设置窗口中选择"快捷键 -> 写作预设"。

标题

1-6级标题的快捷键是Ctrl+1～6, 标题设置后可以自动添加多级数字章节编号，在设置窗口中选择"基础 -> 自动为标题添加多级数字编号"。
列表

列表分有序列表、无序列表、任务列表，快捷键Ctrl+Alt+7～9

📖说明 :

SoloMD有个很有意思的功能，就是任务跟踪，当在任一笔记中存在任务列表格式时，在SoloMD的任务面板上就会有显示，非常方便笔记写作跟踪。

引用

使">"字符放在行首，即可设置为引用格式，快捷键是Ctrl+Alt+Q
代码

代码块是Markdown语言的基础元素，使用快捷键Ctrl+Alt+K设置为代码块
其他格式

表格、行内代码、公式、mermaid图等，都可以通过菜单来设置。表格提供了表格编辑器，未来新版本可能在实时模式(所见所得)提供嵌入式表格编辑能力。

1.3.2.4 AI辅助笔记

1.3.2.4.1 AI的配置

SoloMD内置了很多AI服务提供商，用户选择对应的服务商后，填入自己的APIKey后选择相应的模型即可正常工作，配置过程非常简便，如下图所示：

1.3.2.4.2 AI智能体的使用

方式1:

在SoloMD的编辑器中选中一段需要改写的文字
使用菜单"编辑 -> AI改写选中文字"或直接使用快捷键Ctrl+J，即可弹出AI改写对话框，如下图所示：
根据改写对话框上的选项按钮，选择自己需要的功能，比如扩写，效果如下图所示：

方式2：

在右侧的智能体面板的输入框中输入指令，然后单击"发送"按钮，如下图所示：
待智能体返回结果后，可以单击"插入"按钮直接插入到光标所在位置，如下图所示：

1.3.3 同步功能

同步到Git服务器

在菜单"文件 -> 同步与历史"下有"立即推送"(上传)和"立即拉取"(下载)两个菜单，用于上传和下载笔记
同步到WebDAV服务器

在菜单"文件 -> 同步与历史"下有"WebDAV上传同步"、"WebDAV下载同步"和"WebDAV同步设置"几个功能菜单
同步到个人网盘

网盘同步分两种，一种是在本机使用网盘同步目录，另一种是使用网盘的API直接同步
- 网盘同步目录
  该方式是将笔记库加密打包后，丢到网盘的同步目录，由网盘同步程序，将该文件同步到网盘空间，SoloMD不参与同步过程。
  
  使用网盘同步目录方式进行同步，好处是同步由网盘自己的同步程序处理，配置非常简单；缺点是手机端一般缺少同步功能。
- 网盘API同步
  该方式需要用户申请网盘的APIKey，配置相对复杂，同步由SoloMD进行，不配置同步目录，也不依赖网盘的同步进程。

⚠注意 :

个人网盘的同步配置，基于5.0.13版本，后续版本的升级会对相关网盘同步功能进行优化，在具体的同步教程里再介绍。

作者声明：本文用于记录和分享作者的学习心得，可能有部分文字或示例来自AI平台，如：豆包、元宝、DeepSeek(硅基流动) (注册链接)等，由于本人水平有限，难免存在表达错误，欢迎留言交流和指教！