编辑器基础 — 标签、编码与预览

文档发表:2026-09-27 · 更新 6 次 · 最近更新:2026-10-29 · 阅读:15

中间 X 区就是编辑器。这一篇讲它的三条基础规矩:标签状态语言、编码机器、Markdown 实时预览。

一、标签的四种状态(一眼清)

外观含义
斜体预览态——只是打开看一眼,还没有动过它
正体已固定——你编辑过它(哪怕已保存,仍保持正体)
* 前缀有未保存的改动(Ctrl+S 保存)
灰色 + 删除线文件在磁盘上已删除(内容还在,保存可原地重建)

规矩只有一条:第一次编辑即固定;而且同一文件在任何分组里外观 100% 一致。文件标签上右键还有:在左侧/右侧组再开、关闭其他、全部关闭。

二、打开文件

  • Roam 里按 q(或右键菜单)——文本进编辑器;
  • 楼层 / 预览里的本地路径可点:虚线下划线 = 该文件确实存在;路径带行号(如 core/editor.js:120)时点一下,文件在标签里打开并直接落到第 120 行,行闪一下、该词高亮(与 Ctrl+F 同色);文件已被删除或是个目录则回落到 Roam 定位;
  • 楼层 A4 快照 / 时间线里点文件 = 打开对比窗口(不是编辑,见 文件版本时间线);
  • 想让双击电脑里的文本 / 代码文件也直接进 qd 编辑器?见 文件关联 — 用 qd 打开文本与代码。

三、编码徽标(乱码救星)

文件路径旁(面包屑)恒显一枚编码徽标(如 UTF-8 / GBK / UTF-8 BOM):

  • 读文件自动识别:BOM → 严格 UTF-8 → GBK 兜底——中文老文件不乱码;
  • 点击徽标打开编码方案:按指定编码重新解码,或另存转换为其他编码;
  • 「用当前编码存不进去的字符」(比如 GBK 文件里输入 emoji)会被明确拒绝保存并给出出路(另存为 UTF-8 / 换编码)——绝不会悄悄存成 ? 毁掉内容。

四、Markdown 实时预览

  • 打开 .md 时自动在对侧分组打开渲染预览(可在设置关闭「自动打开 Markdown 预览」);
  • 手动开关:编辑器右下角的悬浮 👁,或键盘 Ctrl+K V;
  • 预览跟随正在编辑的内容——没保存也实时刷新;表格点 View 放大、图片可点开、外链走系统浏览器、本地路径可点直达;
  • 预览里也能找字:Ctrl+F 打开查找条——全部命中橙黄半透、当前命中实橙 + n/m 计数,Enter / Shift+Enter 上下跳,选中文本自动预填;Esc 关闭;
  • 双击选词 → 全文同词高亮:双击任意词,预览里同词全部标出(当前那处保留泥土红选中色);点空白 / Esc 收回。编辑器里那份「双击选词」高亮同一套配色(橙黄实底 + 深金描边,深浅两主题都看得清);
  • 预览面板顶栏挂与编辑器同款面包屑:路径(可选中复制) / 编码徽标(点击改编码) / 复制路径 / Roam 定位 / 版本时间线,随手可用。

五、Ctrl+Z:撤销与重做(逐字回退)

编辑器默认的撤销粒度是逐字:按一次 Ctrl+Z 撤回一次内容变更——打一个字算一次,粘贴一大段也算一次;原生编辑器会把连续打字合成一步,这里不会。Ctrl+Y 或 Ctrl+Shift+Z 重做;回退后又动了内容,原来那条重做分支即作废。回退时连光标与滚动位置一起还原到当时的位置。

撤销深度随正文大小自动收敛(每步都要留一份完整正文,正文越大越占内存):

正文规模最多能连撤
≤ 64 万字符199 步(满额)
约 100 万字符约 133 步
约 200 万字符约 66 步
约 300 万字符约 43 步
超过 300 万字符交给编辑器原生撤销(不限步数,按编辑操作分组)
  • 永远不会有「按了没反应」:正文超过 300 万字符(纯英文约 3 MB、纯中文约 9 MB)时,逐字回退整体让位给编辑器原生撤销——Ctrl+Z 照常有反应,只是粒度变成一次编辑操作、步数不再有 200 这个上限(只受内存约束);正文回落到 300 万字符以内,逐字回退自动接管(不留半截历史);
  • 粘贴的一切同样可撤:图片 / 文件 / 文件夹插进正文后按一次 Ctrl+Z 一步撤回(见 所见即得 — 粘贴一切);
  • AI 输入框、搜索框等单行 / 多行输入框走同一套逐字回退(200 条,单框 10 万字符以内;超出同样让位给浏览器原生,不会按键失效)。

想换成按单词粒度:设置 → 常规 →「编辑器撤销模式」→「单词回退」——原生分组,代码场景更顺手,代价是没有显式 200 步上限、只受内存约束。

撤销只覆盖当前标签在编辑器里的编辑历史。关掉标签、或文件被外部改动后重载,历史就没了——想找回更早的内容去 文件版本时间线,不要指望 Ctrl+Z。

六、设计取舍(诚实说明)

编辑器不做实时报错与自动补全(无重量级语言服务)——保持轻与快。语法把关只在写入侧,且只针对 AI 写文件:AI 每次写文件都会过一道自动语法门(.js / .json,以及 .css / .html 的结构门),不合格就还原原文件并报错,写坏的版本不会留在磁盘上。你自己 Ctrl+S 保存不跑语法检查,只有编码守卫(见上)与「文件被外部改动」的冲突守卫。

延伸阅读:所见即得 — 粘贴一切(把图片、文件直接粘进文档) · 键盘与手势速查