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

文档发表:2026-09-27 · 阅读:1 · 更新:2026-09-27

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

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

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

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

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

二、打开文件

  • Roam 里按 q(或右键菜单)——文本进编辑器;
  • Ctrl+P 快速跳转:最近打开过的文件,输入片段模糊筛选,回车打开;
  • 楼层 A4 快照 / 时间线里点文件 = 打开对比窗口(不是编辑,见 文件版本时间线)。

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

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

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

四、Markdown 实时预览

  • 打开 .md 时自动在对侧分组打开渲染预览(可在设置关闭「自动打开 Markdown 预览」);
  • 手动开关:编辑器右下角的悬浮 👁,或键盘 Ctrl+K V;
  • 预览跟随正在编辑的内容——没保存也实时刷新;表格点 View 放大、图片可点开、外链走系统浏览器、本地路径可点直达。

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

编辑器不做实时报错与自动补全(无重量级语言服务)——保持轻与快。把关在写入侧:AI 每次写文件(以及文件保存)都会经过自动语法校验,失败会还原并报错,不会把写坏的文件留在磁盘上。

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