快捷编辑
需要启用:桌面版在工作区设置中勾选「编辑」;CLI 用
--enable-edit
无需离开浏览器即可编辑 Markdown 源文件。
打开编辑器
| 方式 | 操作 |
|---|---|
| 全局 | 按 e 打开当前文件 |
| 定位到选中文本 | 鼠标选中文本 → 点击工具栏的 编辑 按钮,编辑器自动跳转到对应源码位置并选中 |
编辑器功能
- 行号
- 语法高亮(GitHub 风格,支持浅色/深色主题)
- 滚动条与主文件同步
- 文件修改状态指示(标题中的星号
*)
快捷键
| 快捷键 | 功能 |
|---|---|
| Ctrl/Cmd + S | 保存 |
| Esc | 关闭编辑器返回查看模式 |
保存成功后会刷新查看页面,立即看到新内容。
安全限制
编辑功能有几层保护:
- 仅限
.md文件 — 无法编辑其他类型的文件 - 工作区边界 — 编辑范围严格限制在启动时指定的目录内,不能通过路径穿越编辑外部文件
- 只读文件 — 文件系统标记为只读时拒绝保存
- 错误提示 — 保存失败会显示具体原因(权限、路径、文件类型等)
适用场景
- 本地快速修改 — 发现 typo 或想补充一段,无需切到编辑器
- 远程服务器编辑 — 通过浏览器访问远程 Markon 实例,编辑服务器上的 Markdown 文件
- 团队协作 — 多人在浏览器里编辑同一个工作区
不适合
- 大型复杂编辑 — 编辑器不是 VS Code,缺少代码智能、多光标、插件生态
- 频繁切换文件 — 每次只编辑当前文件,没有多标签
配合共享标注
启用 --shared-annotation 时,编辑保存后会通过 WebSocket 通知其他连接的客户端重新加载文件,实现「多人同看同编辑」效果(但注意没有冲突检测,后保存的覆盖先保存的)。