--- title: "你的第一篇笔记" description: "在 Web 编辑器中创建你的第一篇笔记：文件树、作为首行的标题，以及以纯 .md 文件形式保存到磁盘。" --- # 你的第一篇笔记 装完程序，你已经进到编辑器里了。现在来创建第一篇笔记，看看磁盘上发生了什么：在 Notarium 里，一篇笔记不是别人数据库里的一行记录，而是你自己文件夹中一个普通的 `.md` 文件。你写下的一切都以纯 Markdown 文本躺在那里，任何编辑器都能打开，比 Notarium 本身活得更久。 ## 左侧的文件树 左侧是你空间里文件夹和笔记的树。它与 `/data/spaces` 下的文件结构一一对应：树里的文件夹就是磁盘上的文件夹，笔记就是其中的文件。这棵树能承载数万条目，随着你展开文件夹再按需加载其中内容。 核心操作也在这里：创建笔记或文件夹、就地重命名、用鼠标拖进另一个文件夹。有个重要细节：给已有笔记更改文件夹或标题会**移动文件本身**，而不是复制出一份副本。 > [!note] 空文件夹也是一等公民 > 移走文件夹里最后一篇笔记时，它不会消失。你可以提前把结构搭好。 ## 标题就是首行 Notarium **没有单独的「Title」字段**。笔记的标题就是它开头的 `# H1`，也就是文档的第一行。你直接在正文里编辑它，和其他内容一样。新笔记打开时光标已经停在 `# ` 行的标题处——直接开始输入即可。 如果开头没有 `# H1`，标题就取第一行非空的正文文字——随手记的一笔不会变成一堆「Untitled」的数据库。但如果文档以结构块开头（代码、列表、引用、表格、H2 及以下的标题）且始终没有设定标题，那么这篇笔记在没有标题时无法保存：这样第一行代码就不会悄悄泄进标题里。 标题把文件名、搜索、图谱和历史串在一起——所以只有一个统一的编辑界面，而不是会渐渐脱节的「字段 + 正文」。 ## 写作模式 Notarium 始终编辑**原始 Markdown**——唯一的事实源。编辑时这段文本看起来如何，由写作模式决定（一项个人偏好，位于 **Settings → Appearance**）： - **Source**（默认）——原样呈现的原始 Markdown：等宽字体、语法高亮。`#`、`**`、`[]()` 这些标记显示为普通文本。适合直接与源码打交道的人。 - **WYSIWYM**——「所见即所指」：文本经过样式化（标题更大、粗体渲染为粗体、引用带背景），但 Markdown 标记仍留在屏幕上，只是变暗。行长不变，因此光标不会「乱跳」。 两种模式编辑的是同一行，保存时也字节完全一致——切换模式不会改变文件的内容。 与模式相独立的是顶栏里的 **预览** 按钮：它随时展示笔记最终的 HTML 渲染，而不保存。对于较长的文本，还有写作助手 **Focus**（把活动句子/行/段落之外的一切都调暗）和 **Typewriter**（让带光标的那一行始终居中）。 ## 笔记之间的链接 维基链接在正文里生效：`[[笔记标题]]` 或 `[[标题|显示文字]]`。点击会在应用内跳转到那篇笔记。如果不存在同名标题的笔记，Notarium 会提议创建它——在此之前，它会作为一个空心的「幽灵」节点挂在链接图谱上。 ## 保存，以及磁盘上落下了什么 保存用 `Ctrl/Cmd+Enter`。落到磁盘上的是干净的 Markdown，没有重新转义、也没有重新规范化：正是你敲下的内容。Notarium 从标题推导出文件名（kebab-case，并把西里尔字母转写为拉丁），所以文件在应用之外也读得顺。 文件开头会有一小段 frontmatter，里面有一个 **`notarium-id`** 键：笔记稳定的 12 位标识符。真正代表笔记身份的是它，而不是路径或文件名：重命名、在文件夹间搬动都不会断链、也不会丢失版本历史，因为日志是按 `notarium-id` 记的。 > [!tip] 从外部编辑是一种正常模式 > 在别的编辑器里改了 `.md` 文件，或者从 git 拉了下来？Notarium 会在下一次扫描时接收这些改动。文件始终是事实源；索引只是重新构建以与之匹配。 每次保存都会进入**修订历史**：笔记状态的完整快照，附带溯源信息——谁、以何种方式编辑（你、外部编辑器还是某个智能体）。任何版本都能查看、比较和回滚。 ## 下一步 - [连接智能体](/docs/getting-started/connect-agent/)——让 AI 智能体通过 MCP 写入同一个知识库。 - [编辑器](/docs/guides/editor/) 与 [键盘快捷键](/docs/guides/hotkeys/)——详解模式、格式化和快捷键。 - [文件优先](/docs/concepts/file-first/) 与 [版本与历史](/docs/concepts/versioning/)——存储模型是如何运作的。