实时 Markdown 查看器

面向 AI 协同编辑的实时 Markdown 查看器。协作过程中，内容更新即时渲染。兼容任意 AI Agent 与 Web 浏览器。

GitHub：wipcomputer/wip-markdown-viewer
npm：@wipcomputer/markdown-viewer

安装

npm install -g @wipcomputer/markdown-viewer

该命令将全局安装 mdview 命令。无运行时依赖，纯 Node.js 实现。

快速开始

启动服务（仅绑定到 127.0.0.1，永不暴露于网络）：

curl -s http://127.0.0.1:3000/ > /dev/null 2>&1 || mdview &

在默认浏览器中打开文件：

# macOS
open "http://127.0.0.1:3000/view?path=/absolute/path/to/file.md"

# Linux
xdg-open "http://127.0.0.1:3000/view?path=/absolute/path/to/file.md"

# Windows
start "http://127.0.0.1:3000/view?path=/absolute/path/to/file.md"

工作原理

1. 指示你的 AI 编程工具全局安装 @wipcomputer/markdown-viewer
2. 指示 AI 使用 mdview 打开一个 .md 文件
3. AI 在你的默认浏览器中打开该文件
4. 每次保存后页面自动重新渲染，无需手动刷新

可同时打开多个标签页，以并行处理多个文档。

安全性

• 服务仅绑定至 127.0.0.1，无法从其他设备访问。
• /view?path= 参数从本地文件系统读取文件。可通过 --root 限制可访问的目录树范围。在共享环境中强烈推荐使用此选项。
• 零 npm 依赖。除 Node.js 自身外，不存在供应链风险。

特性

• 基于 SSE 的实时重载（兼容 Safari、Chrome、Firefox）
• 多文件支持（每个标签页独立监听其对应文件）
• GitHub 风格 Markdown（支持表格、任务列表、删除线等）
• 语法高亮（支持 180+ 种编程语言）
• 深色模式
• 目录结构（Table of Contents）
• Mermaid 图表
• KaTeX 数学公式

故障排查

页面显示首页而非目标文件：服务启动时使用了 --root 参数限制了访问路径。请移除该参数后重启服务。

Safari 卡顿或显示空白页：执行强制刷新（Cmd+Shift+R），或重启服务。Safari 对 SSE 连接缓存较为激进。

macOS 的 open 命令丢失查询参数（query string）：请改用 AppleScript：

osascript -e 'tell application "Safari" to open location "http://127.0.0.1:3000/view?path=/your/file.md"'

注意事项

• 服务默认运行于 http://127.0.0.1:3000。如需修改端口，请使用 mdview --port 8080。
• 服务无法在系统重启后自动恢复。快速开始中的 curl 检查语句可在需要时自动重启服务。
• 请勿以文件路径作为参数启动服务（例如 mdview /path/file.md）。务必以无参方式启动（即 mdview）。带路径参数启动会使服务锁定至该目录，导致后续请求失效。
• 可将任意 .md 文件拖拽至首页以直接查看。
• 无任何外部网络请求。所有依赖均已本地打包。