Notarium文档
文档版本: latest

编辑器

Notarium 编辑器始终编辑原始 Markdown 文件——唯一的真实来源。无论你怎么操作,落盘的都是干净的纯 Markdown,不带任何杂质:不重新转义、不重新规范化列表、不折叠 frontmatter。这正是 Notarium 区别于富文本编辑器之处——后者存的是规范化后的语法树,并在保存时重新拼出文件,这个往返过程会丢失部分原始排版。底层用的是 CodeMirror 6:格式化工具栏、键盘快捷键、多光标以及语法高亮。

Source 模式下的编辑器:带语法高亮的原始 Markdown

标题就是第一行

没有单独的「Title」字段。一条笔记的标题就是它开头的 # H1,你直接在文档里把它作为第一行来编辑。新建笔记会直接停在 # 行上,光标就落在标题位置。

  • 如果开头没有 # H1,标题就取第一行非空的正文行——随手记的东西不会变成「Untitled」。
  • 但如果文档以结构块开头(代码围栏、列表、引用、表格,或 H2 及更低级别的标题),且未设置标题,那么这条笔记没有标题就不会保存:这样第一行代码或列表就不会悄悄泄进标题里。

写作模式

在笔记这个单一正文之上,叠加了写作模式——它是一项个人设置,决定你编辑时文本看起来什么样。模式不改变文件的字节:它只是覆盖在一段不变字符串上的装饰,所以切换模式与保存都是逐字节完全一致的。

模式展示的内容
Source原样的原始 Markdown:等宽字体、主题化的语法高亮。你编辑的是标记本身。
WYSIWYM「What you see is what you mean」(所见即所):文本经过样式化(标题更大、加粗显示为粗体、引用和代码带底色),但 Markdown 标记仍保留在屏幕上,以暗淡样式呈现——像一副语义骨架。

Settings → Appearance → Editor mode 中切换(一个 Source / WYSIWYM 的分段控件)。该选择是个人的,存在浏览器里;默认为 Source

Preview 是另一个维度

顶栏的 Preview 按钮会在任意模式下展示笔记最终的 HTML 渲染结果(与阅读模式所见相同),且不保存。「我怎么工作」(Source/WYSIWYM)和「编辑还是查看」(Edit/Preview)是相互独立的。

专注与打字机

在任意模式之上,还有两个各自独立、面向长文写作的辅助功能:

  • Focus 会暗化除光标所在活动单元之外的一切。粒度由你自己选——Sentence / Line / Paragraph(句 / 行 / 段)。快捷键:⌘/Ctrl+Shift+F
  • Typewriter(打字机)让光标所在的行保持在垂直方向居中——文档在其下方滚动。快捷键:⌘/Ctrl+Shift+Y

两者都是能挺过刷新的个人开关。你可以用三种方式打开它们:用快捷键、用编辑器状态栏里的两个图标,以及通过 Settings → Appearance(在那里也可以选择 Focus 的粒度)。

保存与冲突

Ctrl/Cmd+Enter 保存笔记。Notarium 会防止未保存内容丢失,并在同一条笔记被另一个标签页或 AI 智能体并发修改时解决冲突。

通过 MCP 的智能体读写的是与人类相同的那份 Markdown 正文——写作模式与此无关,它纯粹是客户端行为。关于人类与智能体协同工作的更多内容,见 人类与智能体;关于版本历史,见 版本管理

另见:阅读与外观——编辑器继承的字体与字号——以及 键盘快捷键参考