[软件推荐] mo: 使用本地浏览器,阅读远端服务器的 markdown 文件

由于现在越来越多的使用AI,生成了大量 markdown 文件,包含代码的 feature spec 整理、agent 的 skills/mcp 记录、以及原有的大量文档。我通常阅读这些文档,可以在服务器上逐个 vim 打开,或者逐个 scp 回本地打卡,或者 vscode 连接服务器逐个打开文件。vscode 是最方便的,但是文档散落在不同的代码目录,workspace 开的太大 vscode 也并不方便。

为了方便阅读服务器上的 markdown 文档,找到了这个开源软件。k1LoW/mo: mo is a Markdown viewer that opens .md files in a browser.

使用下来,个人最喜欢的几个特色:

  1. 对文件夹递归打开,仅读取和展示 .md 文件,忽略其他文件
  2. 文件夹递归打开,浏览器上可以展示文件夹对应的 tree 结构
  3. 可以通过 --target 将不同的文件放入不同的 group,有各自的 url path 以及侧边栏展示
$ mo README.md                          # Open a single file
$ mo README.md CHANGELOG.md docs/*.md   # Open multiple files
$ mo docs/                              # Open all .md files in a directory
$ mo spec.md --target design            # Open in a named group
$ cat notes.md | mo                     # Read Markdown from stdin

$ mo spec.md --target design      # Opens at http://localhost:6275/design
$ mo api.md --target design       # Adds to the "design" group
$ mo notes.md --target notes      # Opens at http://localhost:6275/notes

$ mo --status              # Show all running mo servers
http://localhost:6275 (pid 12345, v0.12.0)
  default: 5 file(s)
    watching: /Users/you/project/src/**/*.md, /Users/you/project/*.md
  docs: 2 file(s)
    watching: /Users/you/project/docs/**/*.md

$ mo --shutdown            # Shut down the mo server on the default port
$ mo --shutdown -p 6276    # Shut down the mo server on a specific port
$ mo --restart             # Restart the mo server on the default port
1 个赞

试了下,在服务器上运行 mo README.md 就打开一个 6275 端口,然后就是阅读器本体了。

感谢蛙总帮忙补充了一些截图

我补充一个截图,表达一下我最喜欢的功能:从左边的侧边栏能看到,可以通过 --target 将文档放到不同 group,每个group里还有文件夹的 tree 结构

(截图我先删了,文档涉及公司的工作内容,不方便放到论坛公开,我明天再找个合适的截图)

效果挺不错的,大部分格式都支持。

测试文档是这个:https://meta.appinn.net/t/topic/86247

此外,这个工具不仅能看文档,还有文件列表、搜索功能,其实应该可以当作一个轻量级博客搭建工具了 :doge: