你的第一篇笔记

装完程序，你已经进到编辑器里了。现在来创建第一篇笔记，看看磁盘上发生了什么：在 Notarium 里，一篇笔记不是别人数据库里的一行记录，而是你自己文件夹中一个普通的 .md 文件。你写下的一切都以纯 Markdown 文本躺在那里，任何编辑器都能打开，比 Notarium 本身活得更久。

左侧的文件树

左侧是你空间里文件夹和笔记的树。它与 /data/spaces 下的文件结构一一对应：树里的文件夹就是磁盘上的文件夹，笔记就是其中的文件。这棵树能承载数万条目，随着你展开文件夹再按需加载其中内容。

核心操作也在这里：创建笔记或文件夹、就地重命名、用鼠标拖进另一个文件夹。有个重要细节：给已有笔记更改文件夹或标题会移动文件本身，而不是复制出一份副本。

空文件夹也是一等公民

移走文件夹里最后一篇笔记时，它不会消失。你可以提前把结构搭好。

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 记的。

从外部编辑是一种正常模式

在别的编辑器里改了 .md 文件，或者从 git 拉了下来？Notarium 会在下一次扫描时接收这些改动。文件始终是事实源；索引只是重新构建以与之匹配。

每次保存都会进入修订历史：笔记状态的完整快照，附带溯源信息——谁、以何种方式编辑（你、外部编辑器还是某个智能体）。任何版本都能查看、比较和回滚。