已读追踪
需要启用：桌面版在工作区设置中勾选「已读追踪」；CLI 用
--enable-viewed
受 GitHub PR Review 的「Viewed」复选框启发，Markon 按段落级别追踪你的阅读进度。
使用
启用后，每个 H2 及以下级别的标题旁会出现 ☐ 已读 复选框。勾选后：
- 该章节自动折叠
- 标题显示为已读状态（TOC 中变为绿色）
- 状态持久化 —— 下次打开同一文档时恢复
操作方式
鼠标
- 点击标题旁的 ☐ 复选框 — 切换已读状态（会自动折叠/展开）
- 点击已折叠章节下方的占位提示 — 临时展开，不改变已读状态
- 点击标题旁的 折叠 / 展开 链接 — 仅切换显示，不改变已读状态
键盘
- v — 切换当前光标所在章节的已读状态
- o — 折叠/展开当前章节（不改变已读状态）
批量操作
H1 标题下方有一个工具栏：
- 全部已读 — 一键把所有 H2+ 章节标为已读
- 全部未读 — 清空所有已读状态
- 全部折叠 / 全部展开 — 不改变已读状态
折叠行为
已读的章节默认折叠，折叠后会显示一个占位提示行：
⋯ 本节已折叠，点击展开
点击这行即可临时展开；也可以直接点击标题旁的 展开 链接切换。
存储模式
已读状态有两种存储方式：
| 模式 | 启用方式 | 存储位置 | 同步 |
|---|---|---|---|
| 本地 | 默认 | 浏览器 LocalStorage | 单设备 |
| 共享 | --shared-annotation | SQLite 数据库 | 多设备实时同步 |
→ 共享模式详见 共享标注
典型场景
- 阅读技术文档 — 学完一章勾选，下次直接从未读章节继续
- Code Review 文档 — 审阅长文档时标记「已审」段落
- 周期性浏览 — 每次读完一部分做标记，避免重复阅读