Skip to content

快捷编辑

快捷编辑

需要启用:桌面版在工作区设置中勾选「编辑」;CLI 用 --enable-edit

无需离开浏览器即可编辑 Markdown 源文件。

打开编辑器

方式操作
全局e 打开当前文件
定位到选中文本鼠标选中文本 → 点击工具栏的 编辑 按钮,编辑器自动跳转到对应源码位置并选中

编辑器功能

  • 行号
  • 语法高亮(GitHub 风格,支持浅色/深色主题)
  • 滚动条与主文件同步
  • 文件修改状态指示(标题中的星号 *

快捷键

快捷键功能
Ctrl/Cmd + S保存
Esc关闭编辑器返回查看模式

保存成功后会刷新查看页面,立即看到新内容。

安全限制

编辑功能有几层保护:

  1. 仅限 .md 文件 — 无法编辑其他类型的文件
  2. 工作区边界 — 编辑范围严格限制在启动时指定的目录内,不能通过路径穿越编辑外部文件
  3. 只读文件 — 文件系统标记为只读时拒绝保存
  4. 错误提示 — 保存失败会显示具体原因(权限、路径、文件类型等)

适用场景

  • 本地快速修改 — 发现 typo 或想补充一段,无需切到编辑器
  • 远程服务器编辑 — 通过浏览器访问远程 Markon 实例,编辑服务器上的 Markdown 文件
  • 团队协作 — 多人在浏览器里编辑同一个工作区

不适合

  • 大型复杂编辑 — 编辑器不是 VS Code,缺少代码智能、多光标、插件生态
  • 频繁切换文件 — 每次只编辑当前文件,没有多标签

配合共享标注

启用 --shared-annotation 时,编辑保存后会通过 WebSocket 通知其他连接的客户端重新加载文件,实现「多人同看同编辑」效果(但注意没有冲突检测,后保存的覆盖先保存的)。

以 Apache 2.0 协议发布