企业官网建设流程全解析

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、LaTeX），SoloMD 目前主要覆盖 HTML 和 PDF。

2.2 为什么"平替"这个词值得认真对待

很多人一看到"平替"就觉得是"低配版"，其实不然。平替的核心逻辑是：在核心使用场景上达到 80% 以上的体验，但成本降到 0。对于 Markdown 编辑器来说，核心场景就是"打开就能写、写完能看、看完能导出"，SoloMD 在这三点上做得相当扎实。

我实测下来，日常写技术博客、整理项目文档、做会议记录，SoloMD 的体验和 Typora 差距很小。真正有差距的地方在于：

这张表不是要证明谁更好，而是帮你判断自己的需求落在哪一列。如果你只需要写 Markdown、看渲染效果、导出 PDF，SoloMD 完全够用；如果你需要导出 Word 交给不写 Markdown 的同事，那 Typora 的导出能力确实更方便。

2.3 适合迁移的三类人

根据我这段时间的观察，以下三类人迁移到 SoloMD 的收益最明显：

第一类：不想为编辑器付费的个人开发者。写代码已经花了不少钱买 IDE、买云服务，编辑器这种工具能省则省。SoloMD 开源免费，装完就能用，没有任何心理负担。

第二类：公司电脑不允许安装付费软件的打工人。很多公司的软件合规流程很麻烦，装个付费编辑器要走采购审批。SoloMD 开源免费，直接下载安装包就能用，省去一堆流程。

第三类：喜欢折腾、想改源码的技术爱好者。SoloMD 开源，意味着你可以自己改主题、加功能、提 PR。Typora 是闭源的，你只能等官方更新。

3. 安装与首次配置：从下载到能写第一篇文章

3.1 下载与安装的实操步骤

SoloMD 的安装过程比 Typora 还简单，因为不需要激活。具体步骤：

1. 获取安装包：从项目的 GitHub Releases 页面下载对应平台的安装包。Windows 用户下载.exe或.msi，macOS 用户下载.dmg，Linux 用户下载.AppImage或.deb。
2. 安装：Windows 双击安装包按提示下一步；macOS 拖入 Applications 文件夹；Linux 给 AppImage 加执行权限后直接运行。
3. 首次启动：打开后会看到一个简洁的编辑界面，默认可能是分栏模式（左边源码右边预览），也可能是所见即所得模式。

注意：下载安装包时认准项目的官方仓库地址，不要从第三方下载站获取，避免捆绑软件。开源项目的 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_{i=1}^{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。具体操作方式：

1. 找到设置里的"自定义 CSS"或"主题目录"选项
2. 创建一个.css文件，写入你的样式覆盖规则
3. 在设置里指向这个文件，或者放到指定的主题目录

比如你想把正文行高调大一点：

body { line-height: 1.8; font-family: "PingFang SC", "Microsoft YaHei", sans-serif; }

注意：自定义 CSS 需要一点前端基础，改之前建议备份原主题文件。改坏了可以删掉自定义文件恢复默认。

5.3 字体选择的经验

中文字体在 Markdown 编辑器里的显示效果差别很大。我试过几种组合：

• 苹方 + 思源黑体：macOS 上显示效果好，Windows 上需要额外安装
• 微软雅黑 + Consolas：Windows 默认就有，兼容性好
• 思源宋体 + JetBrains Mono：适合长时间阅读，但字体文件较大

我的建议是：正文用系统默认的无衬线字体，代码块用等宽字体。不要为了好看装一堆字体，启动速度和渲染性能都会受影响。

6. 常见问题与排查技巧实录

6.1 Mermaid 渲染失败怎么办

这是我最常遇到的问题，排查思路按顺序来：

我遇到最多的是中文标点问题。Mermaid 语法要求用英文标点，但中文输入法下很容易打出中文括号或逗号，导致解析失败。写 Mermaid 时建议先切到英文输入法。

6.2 数学公式不显示

KaTeX 公式不显示通常有三个原因：

1. 公式开关没开：去设置里确认 KaTeX 支持已启用
2. 语法错误：检查$符号是否配对，反斜杠是否转义
3. 特殊符号不支持：KaTeX 不支持某些 LaTeX 命令，换用支持的写法

一个实用技巧：写复杂公式时，先在 KaTeX 官方支持的符号表里查一下，确认符号可用再写进文档。

6.3 图片显示不出来

图片问题分两种：本地图片和网络图片。

本地图片：检查路径是否正确。如果用相对路径，确认图片相对于 Markdown 文件的位置。我建议统一把图片放在文档同级的assets文件夹，用![](assets/xxx.png)引用。

网络图片：检查链接是否有效，有些图床有防盗链，在编辑器里可能显示不出来。这种情况建议把图片下载到本地再引用。

6.4 导出 PDF 排版错乱

导出 PDF 时排版错乱是跨平台编辑器的通病。常见原因和解决方法：

• 字体缺失：导出时用的字体系统里没有，换成通用字体
• 分页问题：长表格或代码块跨页显示异常，可以在 CSS 里加page-break-inside: avoid
• Mermaid 图表模糊：导出时图表渲染分辨率不够，尝试调大导出缩放比例

我实测下来，导出 PDF 前先切换到预览模式确认排版，比直接导出再检查效率高。

6.5 性能问题：大文件卡顿

Markdown 文件超过几千行后，实时预览可能会卡。我的应对方法：

• 关闭实时预览，用分栏模式手动刷新
• 把大文档拆成多个小文件，用链接互相引用
• 关闭不必要的语法高亮和动画效果

这个不是 SoloMD 独有的问题，Typora 处理超大文件也会卡。根本原因是实时渲染需要不断解析整个文档，文件越大开销越高。

7. 我的实际使用体会和几个小技巧

用 SoloMD 这段时间，最大的感受是**"够用就好"**。它不是功能最强大的 Markdown 编辑器，但它在核心场景上做得扎实，而且没有付费和激活的负担。我现在的写作流程是：SoloMD 写草稿，写完导出 HTML 或 PDF，需要发布到平台的再复制过去。

分享几个我摸索出来的小技巧：

技巧一：用文件夹组织文档。SoloMD 打开文件夹后可以当项目管理，左侧文件树切换文档很方便。我按"项目名/文档类型"两级目录组织，找文件很快。

技巧二：善用快捷键。常用的加粗、斜体、插入链接、插入代码块都有快捷键，记住几个高频的能提升不少效率。具体快捷键在设置里可以查。

技巧三：定期备份。开源软件的更新节奏不稳定，遇到 bug 的概率比商业软件高。我习惯把文档目录放在云盘同步文件夹里，同时每周手动导出一次 PDF 存档。

技巧四：关注项目更新。SoloMD 作为开源项目，功能在持续迭代。遇到问题先去项目的 Issues 页面搜一下，很可能已经有人遇到并解决了。

最后说一句实在话：工具是拿来用的，不是拿来供着的。SoloMD 能不能完全替代 Typora，取决于你的具体需求。但如果你和我一样，核心需求就是"免费、跨平台、能写 Markdown、支持 Mermaid 和公式"，那它值得你花时间试一下。试完不合适，删掉就是了，反正也没花钱。