MX
SoloMD

SoloMD

SoloMD 是一款免费开源的 Markdown 编辑器，支持实时预览、多标签编辑、主题切换和文档导出等功能。

效率代码编辑器文本编辑器
3 浏览0 下载

使用文档

1 篇文档 · 29 个章节

SoloMD 下载安装及使用教程

SoloMD 下载安装及使用教程

SoloMD 是一款免费开源的 Markdown 编辑器，支持实时预览、多标签编辑、主题切换和文档导出等功能。它采用 MIT 开源协议，支持 Windows、macOS、Linux 等平台，适合编写技术文档、博客文章、学习笔记和项目说明。

一、SoloMD 下载

1. 官方下载地址

建议优先从官方网站或 GitHub Releases 下载软件，避免使用来源不明的安装包。

如果 GitHub 下载速度较慢，可以优先尝试项目提供的 Gitee 镜像。

2. Windows 用户如何选择安装包

进入 GitHub Releases 页面，找到最新正式版本，在 Assets 列表中选择对应文件。

文件类型 说明 推荐人群
.msi Windows 安装程序 大多数用户
x64-portable.zip 免安装便携版 不想安装软件的用户
ARM64 安装包 面向 ARM64 架构的 Windows 设备 ARM 设备用户

如果你的电脑是普通的 Intel 或 AMD 处理器，通常选择 x64 版本即可。

注意：请以当前 Release 实际提供的文件名称为准，不同版本的安装包名称可能发生变化。

二、Windows 安装教程

1. 下载安装包

打开官方发布页面：

https://github.com/zhitongblog/solomd/releases

找到最新正式版本，在 Assets 中下载对应的 Windows .msi 安装包。

2. 安装 SoloMD

下载完成后，按照以下步骤操作：

  1. 双击下载的 .msi 文件。
  2. 如果 Windows 弹出用户账户控制提示，确认安装来源可靠后允许继续。
  3. 按照安装向导提示完成安装。
  4. 安装结束后，从开始菜单中搜索 SoloMD。
  5. 点击图标启动软件。

如果你下载的是便携版 ZIP 文件，则先解压，再按照压缩包中的说明运行程序。

3. 首次启动提示

部分 Windows 用户首次启动时可能看到 Microsoft Defender SmartScreen 提示。

遇到提示时，不要直接忽略。先确认安装包确实来自官方发布渠道，并检查文件校验信息。确认来源可信后，再根据系统提示决定是否继续运行。

三、macOS 和 Linux 安装方法

macOS

  1. 打开官方 Releases 页面。
  2. 下载对应的 .dmg 文件。
  3. 打开 DMG 文件。
  4. 按照安装说明将 SoloMD 放入 Applications（应用程序）目录。
  5. 从应用程序中启动软件。

官方也提供 Homebrew 安装方式：

brew install --cask zhitongblog/solomd/solomd

Linux

根据发行版选择对应的安装包：

  • .AppImage：通用应用镜像。
  • .deb：适用于 Debian、Ubuntu 等系统。
  • .rpm：适用于 Fedora、RHEL 等系统。

AppImage 文件下载后，通常需要赋予执行权限：

chmod +x SoloMD*.AppImage

然后运行对应文件。

具体系统要求及安装说明请以官方文档为准：

https://solomd.app/docs/getting-started/

四、SoloMD 基本使用教程

1. 创建 Markdown 文档

启动 SoloMD 后，可以通过软件的文件菜单或新建文档入口创建 Markdown 文件。

Markdown 文件通常使用 .md 扩展名，例如：

我的笔记.md
项目说明.md
技术教程.md

建议先创建一个用于测试的文档，熟悉编辑和保存流程。

2. 编写 Markdown 内容

Markdown 使用简单的标记符号组织文本，不需要手动编写复杂的 HTML。

例如：

# 我的第一篇笔记

## 一、学习目标

今天学习 Markdown 的基本语法。

## 二、任务清单

- 安装 SoloMD
- 创建 Markdown 文件
- 学习标题和列表
- 导出文档

## 三、重点内容

**这是加粗文本。**

*这是斜体文本。*

[SoloMD 官网](https://solomd.app/zh/)

在编辑器中输入上述内容后，可以查看预览区域的渲染效果。

3. 实时预览

SoloMD 支持 Markdown 实时预览。

编写内容时，可以直接查看标题、列表、链接和其他格式的最终显示效果。

如果你习惯边写边看，可以根据自己的使用习惯调整编辑和预览布局。

4. 保存文档

编辑完成后，使用软件的保存功能保存文件。

建议将文档保存到一个固定的文件夹中，例如：

Documents/
└── MyNotes/
    ├── 学习笔记.md
    ├── 项目说明.md
    └── 工作记录.md

Markdown 文件本质上是文本文件，可以使用其他 Markdown 编辑器或代码编辑器打开。

5. 管理多个文档

如果需要同时编写多篇文章，可以将文档按主题分类保存。

例如：

MyNotes/
├── 编程/
│   ├── Java.md
│   └── Python.md
├── 运维/
│   └── Docker.md
└── 产品/
    └── 产品规划.md

合理的文件夹结构有助于后续查找、备份和迁移。

6. 导出文档

如果需要将 Markdown 转换成其他格式，可以在 SoloMD 的 File（文件）菜单中查找 Export（导出）功能。

根据当前版本提供的选项，可以将文档导出为 PDF、Word 等格式。

如果菜单名称或支持的格式与本文不同，请以当前安装版本的实际界面为准。

五、SoloMD 的进阶功能

完成基本编辑后，还可以继续了解以下功能。

1. 主题与外观

SoloMD 支持主题和外观配置，可以根据个人喜好调整编辑体验。

2. AI 功能

SoloMD 提供 AI 相关能力，可用于辅助处理笔记、改写内容等。

部分 AI 功能需要配置模型服务或 API Key。是否产生费用取决于所使用的模型服务及其计费规则，不能将第三方模型服务一概视为免费。

3. AI 工具集成

SoloMD 包含 MCP 相关能力，可以让支持 MCP 的 AI 客户端访问指定的 Markdown 工作区。

这是进阶功能。普通用户只需使用 Markdown 编辑和文档管理功能即可，不需要一开始就配置 MCP。

详细说明请参考项目文档：

https://github.com/zhitongblog/solomd

六、常见问题

1. GitHub 下载速度很慢怎么办？

可以尝试以下方式：

  • 通过项目 README 中的 Gitee 镜像下载。
  • 更换网络环境后重试。
  • 使用官方 Releases 页面选择适合自己系统的安装包。

不要为了追求下载速度而随意安装来源不明的修改版。

2. Windows 提示无法确认发布者怎么办？

先检查安装包的来源、文件名称和官方提供的 SHA-256 校验信息。

如果无法确认文件是否来自官方渠道，不建议继续安装。

3. Markdown 文件可以用其他软件打开吗？

可以。.md 文件属于纯文本格式，可以使用其他 Markdown 编辑器或文本编辑器打开。

4. SoloMD 是否需要注册账号？

基本的本地 Markdown 编辑不需要注册账号。AI、同步或其他依赖外部服务的功能，可能需要额外配置，具体以官方当前版本说明为准。

5. SoloMD 是完全免费的吗？

SoloMD 采用 MIT 开源协议，基础软件免费使用。若调用第三方 AI 模型或外部服务，可能需要单独支付相应费用。

七、总结

SoloMD 是一款适合日常 Markdown 写作的免费开源工具。对于刚开始使用 Markdown 的用户，建议先掌握以下几个操作：

  1. 从官方渠道下载安装软件。
  2. 创建并保存 .md 文档。
  3. 熟悉标题、列表、链接等基础语法。
  4. 使用实时预览检查排版效果。
  5. 学会将文档导出为需要的格式。

熟悉这些基础功能后，再根据需要学习 AI 辅助写作、MCP 集成等进阶能力。

官方资源：

客服
反馈