实时协作 (Live)
Markon Live 主要用于团队一起阅读文档的场景,比如产品宣讲或者评审会。
通过“同屏审阅”机制,团队成员可以实时同步彼此的视线焦点,消除远程会议中“找不到主讲人说在哪”的沟通成本。
核心机制
1. 身份标识
身份仅由颜色区分。每个客户端在面板里挑选一个代表色;主控广播时,边框、.heading-focused 呼吸灯起点都会用这个颜色。默认提供 8 种色值(蓝 / 玫红 / 绿 / 橙 / 紫 / 天蓝 / 粉 / 青),客户端之间互不干扰。
2. 协作球控制面板
Markon Live 的前台交互围绕一个常驻页面的悬浮协作球展开。点击展开控制面板,内含一个三态互斥模式选择:关闭 / 主控 / 被控。
- 关闭(Off):默认状态。既不广播也不接收,独立阅读。
- 主控(Broadcast):同步自己的 section 焦点、文本选区、Viewed 勾选,给所有被控端。协作球描上一圈自己的代表色环。
- 被控(Follow):接收主控端的动作并平滑滚动定位。看到主控端聚焦新 section 时,目标 section 会用对方的代表色起一个呼吸灯,然后过渡到默认焦点边框色。
实时同步特性
精准锚点跳转
不同于简单的坐标同步,Markon Live 基于 XPath 路径 进行同步。这意味着:
- 跨设备兼容:即使主讲人在 4K 宽屏上,而您在手机上,Markon 也能确保您看到的是同一个段落或标题。
- 平滑滚动:视线切换伴随平滑过渡,避免突兀的画面跳变。
使用场景
- 技术文档评审:主讲人带读设计文档,参与者自动随动,配合 Section Viewed 确认进度。
- 代码/配置审查:在浏览器中直接展示复杂的 Markdown 配置说明,精准指引每一行变更。
- 读书会/协同学习:多人同时阅读同一文档,实时分享精彩段落。
如何开启
Live 功能默认处于关闭状态(尊重独立阅读体验),您可以按需开启:
桌面版 (GUI)
- 全局默认:在 General → Features enabled by default for new workspaces 勾选 Live。
- 单个工作区:在 Workspaces 选项卡的工作区卡片上勾选 Live 复选框。
命令行 (CLI)
启动时添加 --enable-live 参数:
bash
markon README.md --enable-live键盘快捷键
| 快捷键 | 功能 |
|---|---|
| l | 主控 ⇄ 被控切换(即使当前为关闭也直接进入循环) |
| Shift + l | 关闭 ⇄ 上一次激活模式切换 |
提示:实时协作基于 WebSocket 指令流,仅在中转指令时占用极低带宽,不会将您的文档内容上传至任何云端,确保 100% 本地化隐私。