1. 为什么我又换回了本地 Markdown 编辑器用了几年 Typora从 0.11 免费版一路跟到 1.x 收费版中间也折腾过 Obsidian、VS Code 加插件、Joplin 这些方案。说实话 Typora 的所见即所得确实做得舒服但 15 美元买断之后每次换电脑、换系统都要重新激活偶尔还会遇到激活状态失效、弹窗提示的问题尤其是公司电脑和个人笔记本来回切的时候那种我明明买过了为什么还要再输一遍序列号的烦躁感相信不止我一个人体会过。后来在 GitHub 上翻到一个叫SoloMD的项目定位很直接开源、免费、跨平台目标就是做 Typora 的平替。我抱着试试看不行就删的心态装了一周结果到现在主力写作环境已经切过去了。这篇文章就把我这段时间的使用体验、配置细节、踩过的坑以及它和 Typora 到底差在哪一次性讲清楚。先说清楚这篇文章适合谁看如果你平时用 Markdown 写技术文档、博客草稿、项目 README或者做笔记、写论文提纲又不想为一个编辑器付费、不想被激活机制折腾那 SoloMD 值得你花半小时试一下。如果你重度依赖 Typora 的某些独有功能比如特定的主题生态或者某些导出格式那看完再决定要不要迁移。全文基于我实际使用中的观察和配置涉及具体参数和步骤的地方我会写清楚操作意图方便你直接抄作业。2. SoloMD 到底是个什么东西和 Typora 差在哪2.1 核心定位开源免费的跨平台 Markdown 编辑器SoloMD 的本质是一个基于 Web 技术栈构建的桌面 Markdown 编辑器通过 Electron 或类似的跨平台框架打包成 Windows、macOS、Linux 都能跑的桌面应用。这一点和 Typora 早期的架构思路类似但 SoloMD 选择了完全开源、完全免费的路线没有付费墙没有激活码没有试用期结束后功能受限这种设计。它的核心能力包括实时预览 / 所见即所得左边写 Markdown右边实时渲染或者切换到纯所见即所得模式Mermaid 图表支持流程图、时序图、ER 图、思维导图都能直接在文档里渲染KaTeX 数学公式行内公式和块级公式都支持写技术文档和论文提纲够用代码块高亮支持主流编程语言的语法高亮多平台同步通过本地文件系统或云盘同步文件夹实现跨设备使用导出功能支持导出 HTML、PDF 等常见格式和 Typora 相比SoloMD 最大的差异不在功能列表上而在使用成本和自由度上。Typora 是买断制SoloMD 是开源免费Typora 的主题生态更成熟SoloMD 的主题系统相对简单但可定制Typora 的导出格式更丰富比如支持导出 Word、LaTeXSoloMD 目前主要覆盖 HTML 和 PDF。2.2 为什么平替这个词值得认真对待很多人一看到平替就觉得是低配版其实不然。平替的核心逻辑是在核心使用场景上达到 80% 以上的体验但成本降到 0。对于 Markdown 编辑器来说核心场景就是打开就能写、写完能看、看完能导出SoloMD 在这三点上做得相当扎实。我实测下来日常写技术博客、整理项目文档、做会议记录SoloMD 的体验和 Typora 差距很小。真正有差距的地方在于对比维度TyporaSoloMD价格买断制付费完全免费开源激活机制需要序列号激活无需激活主题生态丰富社区主题多相对简单可自定义导出格式HTML/PDF/Word/LaTeX 等HTML/PDF 为主Mermaid 支持支持支持KaTeX 支持支持支持跨平台Win/Mac/LinuxWin/Mac/Linux源码开放否是这张表不是要证明谁更好而是帮你判断自己的需求落在哪一列。如果你只需要写 Markdown、看渲染效果、导出 PDFSoloMD 完全够用如果你需要导出 Word 交给不写 Markdown 的同事那 Typora 的导出能力确实更方便。2.3 适合迁移的三类人根据我这段时间的观察以下三类人迁移到 SoloMD 的收益最明显第一类不想为编辑器付费的个人开发者。写代码已经花了不少钱买 IDE、买云服务编辑器这种工具能省则省。SoloMD 开源免费装完就能用没有任何心理负担。第二类公司电脑不允许安装付费软件的打工人。很多公司的软件合规流程很麻烦装个付费编辑器要走采购审批。SoloMD 开源免费直接下载安装包就能用省去一堆流程。第三类喜欢折腾、想改源码的技术爱好者。SoloMD 开源意味着你可以自己改主题、加功能、提 PR。Typora 是闭源的你只能等官方更新。3. 安装与首次配置从下载到能写第一篇文章3.1 下载与安装的实操步骤SoloMD 的安装过程比 Typora 还简单因为不需要激活。具体步骤获取安装包从项目的 GitHub Releases 页面下载对应平台的安装包。Windows 用户下载.exe或.msimacOS 用户下载.dmgLinux 用户下载.AppImage或.deb。安装Windows 双击安装包按提示下一步macOS 拖入 Applications 文件夹Linux 给 AppImage 加执行权限后直接运行。首次启动打开后会看到一个简洁的编辑界面默认可能是分栏模式左边源码右边预览也可能是所见即所得模式。注意下载安装包时认准项目的官方仓库地址不要从第三方下载站获取避免捆绑软件。开源项目的 Releases 页面是最安全的来源。3.2 首次配置这五个设置建议先改装完之后别急着写先把这几个设置调好后面用起来会舒服很多第一切换编辑模式。SoloMD 通常提供源码模式分栏模式所见即所得模式三种。我个人的习惯是写技术文档用分栏模式写博客草稿用所见即所得模式。你可以在设置里找到编辑模式或视图模式选项切换。第二设置默认字体和字号。默认字体往往偏小长时间写作眼睛累。我一般把正文字号调到 16px代码块字号调到 14px行高调到 1.6 到 1.8 之间。这个没有标准答案按自己舒服来。第三配置文件保存位置和自动保存。找到文件或设置里的自动保存选项建议开启间隔设为 30 秒到 1 分钟。同时确认默认保存目录建议设成一个你经常同步的文件夹比如云盘同步目录这样跨设备也能用。第四开启 Mermaid 和 KaTeX 支持。这两个功能在设置里通常有开关确认打开。有些版本默认开启有些需要手动勾选。第五配置图片保存路径。如果你经常截图贴到文档里建议设置图片自动保存到文档同级的assets文件夹并开启使用相对路径。这样文档和图片一起移动时不会断图。3.3 一个容易被忽略的细节文件编码Markdown 文件本质是纯文本编码格式直接影响中文显示。SoloMD 默认应该是 UTF-8但如果你打开别人发来的文件出现乱码检查一下编码设置。我遇到过同事用 GBK 编码保存的 Markdown 文件在 SoloMD 里打开全是乱码手动切换编码后正常。这个坑不常遇到但遇到了很抓狂。4. 核心功能深度拆解Mermaid、KaTeX 和代码块4.1 Mermaid 图表让文档里的流程图活起来Mermaid 是我用 SoloMD 最频繁的功能之一。它的价值在于用纯文本描述图表版本可控改起来方便。传统画流程图要开 Visio 或 draw.io画完导出图片再贴到文档里改一个框就要重新导出。Mermaid 直接写在 Markdown 里改文字就是改图。SoloMD 对 Mermaid 的支持覆盖了常见图表类型流程图flowchart画业务流程、系统架构时序图sequenceDiagram画接口调用顺序、交互流程ER 图erDiagram画数据库表关系思维导图mindmap整理知识结构甘特图gantt做项目排期写一个流程图的语法大概是这样flowchart TD A[开始] -- B{条件判断} B --|是| C[执行操作] B --|否| D[跳过] C -- E[结束] D -- E注意Mermaid 语法对空格和缩进敏感尤其是节点定义和连线之间的空格。如果渲染失败先检查是不是少了空格或者用了中文标点。我踩过的一个坑是Mermaid 的节点文字里如果包含括号、引号等特殊字符需要用引号把文字包起来否则解析会出错。比如A[包含(括号)的文字]这样写才安全。4.2 KaTeX 数学公式写技术文档够用了KaTeX 是比 MathJax 更轻量的数学公式渲染引擎渲染速度快适合实时预览场景。SoloMD 集成 KaTeX 后行内公式用$...$块级公式用$$...$$。举个实际例子写机器学习文档时经常要写损失函数$$L(\theta) \frac{1}{2m} \sum_{i1}^{m} (h_\theta(x^{(i)}) - y^{(i)})^2$$渲染出来就是标准的数学公式样式。KaTeX 支持的符号和命令覆盖了大部分常用场景但如果你要写非常复杂的公式比如某些物理或数学专业领域的特殊符号可能会遇到不支持的情况。这种时候要么换写法要么用图片代替。提示KaTeX 和 MathJax 的语法有细微差别如果你从其他平台复制公式过来渲染失败先确认是不是语法不兼容。4.3 代码块高亮程序员的基本需求代码块高亮看起来是基础功能但实际体验差别很大。SoloMD 的代码高亮支持主流语言写代码示例时指定语言类型就能正确高亮def fibonacci(n): if n 1: return n return fibonacci(n-1) fibonacci(n-2)我实测下来Python、JavaScript、Go、Rust、SQL、Bash 这些常用语言的高亮都没问题。行内代码用反引号包裹比如npm install这样。一个小技巧如果你贴的代码很长可以在代码块前后加折叠标记如果 SoloMD 支持的话或者用注释标注重点行。这个不是 SoloMD 独有功能但配合使用能提升文档可读性。5. 主题定制与个性化让编辑器看起来顺眼5.1 内置主题切换SoloMD 通常内置几套主题比如亮色、暗色、护眼模式等。切换方式一般在设置里或者快捷键。我个人的习惯是白天用亮色主题晚上切暗色减少眼睛疲劳。主题切换不只是换个背景色好的主题会调整字体、行高、代码块配色、表格样式等一整套视觉元素。SoloMD 的内置主题虽然不如 Typora 社区主题那么丰富但基本够用。5.2 自定义 CSS进阶玩家的玩法如果你对内置主题不满意SoloMD 作为开源项目通常支持自定义 CSS。具体操作方式找到设置里的自定义 CSS或主题目录选项创建一个.css文件写入你的样式覆盖规则在设置里指向这个文件或者放到指定的主题目录比如你想把正文行高调大一点body { line-height: 1.8; font-family: PingFang SC, Microsoft YaHei, sans-serif; }注意自定义 CSS 需要一点前端基础改之前建议备份原主题文件。改坏了可以删掉自定义文件恢复默认。5.3 字体选择的经验中文字体在 Markdown 编辑器里的显示效果差别很大。我试过几种组合苹方 思源黑体macOS 上显示效果好Windows 上需要额外安装微软雅黑 ConsolasWindows 默认就有兼容性好思源宋体 JetBrains Mono适合长时间阅读但字体文件较大我的建议是正文用系统默认的无衬线字体代码块用等宽字体。不要为了好看装一堆字体启动速度和渲染性能都会受影响。6. 常见问题与排查技巧实录6.1 Mermaid 渲染失败怎么办这是我最常遇到的问题排查思路按顺序来问题现象可能原因解决方法图表不渲染显示源码Mermaid 开关未开启检查设置里的 Mermaid 支持选项渲染报错提示语法错误语法写错检查空格、标点、节点定义部分节点显示异常特殊字符未转义用引号包裹含特殊字符的文字图表显示但样式错乱主题冲突切换主题或检查自定义 CSS我遇到最多的是中文标点问题。Mermaid 语法要求用英文标点但中文输入法下很容易打出中文括号或逗号导致解析失败。写 Mermaid 时建议先切到英文输入法。6.2 数学公式不显示KaTeX 公式不显示通常有三个原因公式开关没开去设置里确认 KaTeX 支持已启用语法错误检查$符号是否配对反斜杠是否转义特殊符号不支持KaTeX 不支持某些 LaTeX 命令换用支持的写法一个实用技巧写复杂公式时先在 KaTeX 官方支持的符号表里查一下确认符号可用再写进文档。6.3 图片显示不出来图片问题分两种本地图片和网络图片。本地图片检查路径是否正确。如果用相对路径确认图片相对于 Markdown 文件的位置。我建议统一把图片放在文档同级的assets文件夹用引用。网络图片检查链接是否有效有些图床有防盗链在编辑器里可能显示不出来。这种情况建议把图片下载到本地再引用。6.4 导出 PDF 排版错乱导出 PDF 时排版错乱是跨平台编辑器的通病。常见原因和解决方法字体缺失导出时用的字体系统里没有换成通用字体分页问题长表格或代码块跨页显示异常可以在 CSS 里加page-break-inside: avoidMermaid 图表模糊导出时图表渲染分辨率不够尝试调大导出缩放比例我实测下来导出 PDF 前先切换到预览模式确认排版比直接导出再检查效率高。6.5 性能问题大文件卡顿Markdown 文件超过几千行后实时预览可能会卡。我的应对方法关闭实时预览用分栏模式手动刷新把大文档拆成多个小文件用链接互相引用关闭不必要的语法高亮和动画效果这个不是 SoloMD 独有的问题Typora 处理超大文件也会卡。根本原因是实时渲染需要不断解析整个文档文件越大开销越高。7. 我的实际使用体会和几个小技巧用 SoloMD 这段时间最大的感受是**够用就好**。它不是功能最强大的 Markdown 编辑器但它在核心场景上做得扎实而且没有付费和激活的负担。我现在的写作流程是SoloMD 写草稿写完导出 HTML 或 PDF需要发布到平台的再复制过去。分享几个我摸索出来的小技巧技巧一用文件夹组织文档。SoloMD 打开文件夹后可以当项目管理左侧文件树切换文档很方便。我按项目名/文档类型两级目录组织找文件很快。技巧二善用快捷键。常用的加粗、斜体、插入链接、插入代码块都有快捷键记住几个高频的能提升不少效率。具体快捷键在设置里可以查。技巧三定期备份。开源软件的更新节奏不稳定遇到 bug 的概率比商业软件高。我习惯把文档目录放在云盘同步文件夹里同时每周手动导出一次 PDF 存档。技巧四关注项目更新。SoloMD 作为开源项目功能在持续迭代。遇到问题先去项目的 Issues 页面搜一下很可能已经有人遇到并解决了。最后说一句实在话工具是拿来用的不是拿来供着的。SoloMD 能不能完全替代 Typora取决于你的具体需求。但如果你和我一样核心需求就是免费、跨平台、能写 Markdown、支持 Mermaid 和公式那它值得你花时间试一下。试完不合适删掉就是了反正也没花钱。