由于现在越来越多的使用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.
使用下来,个人最喜欢的几个特色:
- 对文件夹递归打开,仅读取和展示 .md 文件,忽略其他文件
- 文件夹递归打开,浏览器上可以展示文件夹对应的 tree 结构
- 可以通过 --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

