---
title: "编辑器"
description: "编辑原始 Markdown、写作模式、格式化、专注与保存。"
---

# 编辑器

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

![Source 模式下的编辑器：带语法高亮的原始 Markdown](/media/app-editor-light.webp)

## 标题就是第一行

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

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

## 写作模式

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

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

在 **Settings → Appearance → Editor mode** 中切换（一个 `Source / WYSIWYM` 的分段控件）。该选择是个人的，存在浏览器里；默认为 **Source**。

> [!note] 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 正文——写作模式与此无关，它纯粹是客户端行为。关于人类与智能体协同工作的更多内容，见 [人类与智能体](/docs/concepts/human-and-agents/)；关于版本历史，见 [版本管理](/docs/concepts/versioning/)。

另见：[阅读与外观](/docs/guides/reading/)——编辑器继承的字体与字号——以及 [键盘快捷键参考](/docs/reference/keyboard-shortcuts/)。