快速上手
从下载到保存第一篇笔记,大约只需三分钟。
1. 安装
| 平台 | 方式 |
|---|---|
| macOS | brew install --cask zhitongblog/solomd/solomd,或从 solomd.app 下载已签名的通用 .dmg,拖进「应用程序」即可。需要 macOS 10.15+。 |
| Windows | 下载 .msi(x64 或 arm64)——安装到 C:\Program Files\SoloMD。不想安装的话也有便携版 ZIP。需要 Windows 10+(为什么不支持 Windows 7)。 |
| Linux | .AppImage、.deb 或 .rpm,均提供 x64 与 arm64。 |
| iOS / Android | iOS 15+ 上架 App Store;Android 7+ 可侧载 APK,或加入 Play 商店测试版。 |
Windows:任务栏图标显示空白?
如果升级后任务栏按钮或固定项的 SoloMD 图标是空白的,那是 Windows 图标缓存里残留了坏条目——卸载重装也不会清除它。在命令提示符里执行以下四行,然后重新固定即可:
taskkill /f /im explorer.exe
del /f /q %LocalAppData%\IconCache.db
del /f /q %LocalAppData%\Microsoft\Windows\Explorer\iconcache_*.db
start explorer.exe 2. 直接开始打字
首次启动会打开几篇简短的欢迎文档 —— 看一眼或直接关掉都行。 你可以立刻开始输入:内容先保存在内存中,直到你按下 Ctrl/⌘ S 保存;未保存的草稿在应用重启后也会通过会话恢复保留下来。 未命名的标签页会在第一次保存时询问文件名。
3. 打开文件或文件夹
- 单个文件:文件 → 打开(Ctrl/⌘ O)、把文件拖进窗口,或直接双击
.md文件 —— SoloMD 会注册为 Markdown 编辑器。 - 文件夹(推荐):文件 → 打开文件夹。这个文件夹就成了你的工作区:左侧出现文件树,搜索 / 标签 / 反向链接 / 关系图会索引其中的每一篇笔记,并且每个文件夹会各自记住打开过的标签页。
4. 标签页与分栏
- 每篇文档就是一个标签页。拖拽可以调整顺序,Ctrl/⌘ W 关闭。
- 在命令面板(Ctrl/⌘ Shift K → “向右拆分编辑器”)里可以把编辑器向右或向下拆分,并排查看两篇笔记。
- 命令面板列出了应用里的每一个操作及其快捷键 —— 拿不准的时候,打开它输入你想做的事就行。它会跟随你的界面语言。
5. 选一个视图模式
| 模式 | 你看到的 |
|---|---|
| 纯编辑 | 带语法高亮的 Markdown 源码。 |
| 实时编辑 | 所见即所得:格式就地渲染,光标所在行显示原始源码。表格、公式、Mermaid、图片和内嵌 HTML 都会以块的形式渲染。 |
| 分栏 | 左边源码、右边渲染预览,滚动像素级同步。 |
| 预览 / 阅读模式 | 只显示渲染结果;阅读模式是为长文准备的全宽衬线排版。 |
用 Ctrl/⌘ Shift P 循环切换模式,或点击工具栏上的模式按钮。
6. 保存与安全网
- Ctrl/⌘ S 写入磁盘。当标签页没有未保存的修改时,被其他程序改动的文件会自动重新加载 —— 有未保存修改的标签页则一定会先询问你。
- 可选的失焦自动保存和 Git 历史(自动快照 + 一键回滚)都在设置里 —— 见同步与历史。
- 笔记就是文件夹里的普通
.md文件。没有数据库,没有锁定 —— 任何其他工具都可以直接指向同一个目录。
下一步
- 编辑器详解 —— 实时渲染、图片、表格、Vim 模式、打字机模式。
- 工作区与组织 —— 大纲、搜索、标签、反向链接、保存的视图。
- 同步、历史与备份 —— GitHub 同步,可选端到端加密。
- AI 功能 —— 用自己的 API Key,或用 Ollama 完全本地运行。
Comments & feedback
Comments live on GitHub Discussions — sign in once with your GitHub account.
Comments load from GitHub Discussions. If you see this message instead, the maintainer has not finished the one-time giscus.app setup yet — see web/COMMUNITY-SETUP.md.
Open on GitHub Discussions →