mo Markdown：浏览器里看

本地一堆 .md 文档，想在浏览器里看渲染效果，还得装编辑器或插件？本篇讲 mo：一款用 Go 编写的本地 Markdown 查看器，在命令行里敲一行命令，就能在浏览器中打开 .md 文件，保存后页面自动刷新，还自带代码高亮、Mermaid 图表和 KaTeX 公式渲染。下面把 mo 的安装、常用命令和注意事项一次讲清。

mo 软件信息一览

版本选择：先给结论

结论：macOS 用户直接走 Homebrew 安装最省事；Windows 和 Linux 用户去 Releases 页下载对应系统与架构的二进制文件。除非你要改它的代码，否则完全没必要自己编译。

mo 版本对比与推荐

结论先行：推荐 macOS 用户用 Homebrew 正式版，Windows 与 Linux 用户用 Releases 二进制正式版；源码编译版只推荐给想改代码的开发者，普通用户不必为此装 Go 环境。

安装步骤（只写关键卡点）

1. macOS：执行 brew install k1LoW/tap/mo，装完运行 mo --version 能打印版本号即成功。卡点：tap 名称大小写别写错。
2. Windows / Linux：打开仓库 Releases 页，下载对应系统与架构的压缩包，解压后把 mo 放到 PATH 目录（如 /usr/local/bin）；Linux 下记得先 chmod +x 给执行权限。
3. 验证安装：找个 .md 文件执行 mo README.md，mo 会在本地启动服务并自动打开浏览器。卡点：无头服务器没有浏览器时页面打不开不代表服务没起，看终端输出的本地地址，复制到有浏览器的机器上访问即可。
4. 端口规则：默认使用本地 6275 端口。同一端口上已有服务时，后续的 mo 调用会把文件加入已有会话，而不是另起服务；需要完全独立的会话，用不同端口启动（具体参数见 mo --help）。

上手必会的 4 个用法

• 分组打开文档：mo README.md CHANGELOG.md docs/*.md 一次打开多个文件；mo spec.md --target design 把相关文档放进命名分组。体感：看项目文档时 README、更新日志、设计稿各归一组，侧栏一切换就是一次上下文切换。
• 目录批量预览：mo docs/ 打开目录下全部 .md 文件，还可配合 watch 与 recursive 选项做持续预览。体感：写技术文档时边写边看，不用来回切换编辑器的预览标签。
• 管道直接渲染：cat notes.md | mo，或把任意命令的输出喂给它：some-command | mo --target output。体感：脚本生成的 Markdown（如测试报告、更新日志草稿）不用先落盘，直接在浏览器里看排版效果。
• 界面随手微调：右上角可切换深色 / 浅色主题、内容宽窄、四档字号；图片和 Mermaid 图支持全屏放大查看。体感：读长文档时开窄栏加大字号，眼睛舒服很多。

mo 阅读设置：3 处随手可调

• 主题：深色 / 浅色。入口：页面右上角主题切换。体感差别：晚上读长文档切深色，白天切浅色，不用改系统主题就能换阅读氛围。
• 栏宽与字号。入口：页面右上角宽窄与字号选项（共四档字号）。体感差别：长文档开窄栏加大字号，一屏行数少了、眼睛不用左右扫，读技术文档更省力；看表格多的文档再切回宽栏。
• 分组侧栏。入口：页面侧栏分组切换（配合命令行 –target 分组）。体感差别：README、更新日志、设计稿分开成组后，侧栏一切换就是一次上下文切换，不用来回找文件。

注意事项与常见问题

• 拖进来的文件不会自动刷新：从系统文件管理器拖放加入的文件是加载进内存的，据项目说明这类文件不支持实时刷新。解决办法：用命令行 mo 文件名 的方式打开，保存后页面才会自动跟随刷新。
• 开了两个终端，文件怎么混到一起了？这是默认的单服务模型：6275 端口上已有服务时，后续调用都会并入已有会话。这是设计如此，不是 bug；要隔离就用不同端口启动独立会话。
• MDX 不是完整执行环境：.mdx 文件只会按 Markdown 渲染，其中的 import / export 会被剥离、JSX 标签会被转义。结论：只能看，不能跑组件；需要 MDX 组件执行能力请用专用工具链。
• 和静态站点生成器的分工：mo 只解决”在本地看”，不解决”发布成网站”。如果你的需求是把文档发布出去，请用 Hugo、VitePress 这类静态站点生成器，别指望 mo。
• 服务起不来先查端口：确认 6275 是否被其他程序占用；换个端口另起会话通常是最快的解决办法。

mo 常见报错与排错

• 服务起不来：先查 6275 端口是否被其他程序占用；被占用就换个端口另起独立会话，不要在原端口上反复重试。
• 保存后页面不刷新：先确认文件是不是从文件管理器拖放加入的，拖放文件加载进内存、不支持实时刷新；改用命令行 mo 文件名 打开，保存后页面才会自动跟随刷新。
• 无头服务器上页面打不开：这不代表服务没起，看终端输出的本地地址，复制到有浏览器的机器上访问即可。
• 两个终端的文件混到一起：这是默认单服务模型，6275 端口上已有服务时后续调用都会并入已有会话；要隔离就用不同端口启动独立会话。

mo 适合谁、不适合谁

适合：在浏览器里阅读、预览、整理本地 Markdown 的开发者、技术写作者和项目维护者；经常要看 README、技术文档、设计说明，并需要 Mermaid 图表和数学公式预览的人。不适合：要把文档发布成网站的人；需要完整 MDX 组件执行环境的人；需要远程多用户协作和权限管理的人——这三类需求都在 mo 的能力边界之外，选型前先看仓库说明或换工具。

前往 GitHub 开源地址

GitHub 国内访问较慢，如打不开可多刷新几次

推广

关注「软件教程管家」

回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。

相关推荐

开源项目WallpaperMachine 免费下载开发node-rs 免费下载｜Rust 原生绑定包集合开发Roundhouse 免费下载｜Ruby 静态分析开发Flatcar Container Linux 免费下载开发Nature Skills 免费下载开发bddisasm 免费下载｜轻量级 C 指令解码库