Первая заметка

Вы прошли установку и оказались в редакторе. Теперь создадим первую заметку и посмотрим, что происходит на диске: в Notarium заметка — это не строка в чужой базе, а обычный .md-файл в вашей папке. Всё, что вы напишете, лежит понятным Markdown-текстом, который откроется в любом редакторе и переживёт сам Notarium.

Дерево файлов слева

Слева — дерево папок и заметок вашего пространства. Оно один в один отражает файловую структуру в /data/spaces: папка в дереве — папка на диске, заметка — файл в ней. Дерево рассчитано на десятки тысяч записей и подгружает содержимое папок по мере раскрытия.

Здесь же — основные операции: создать заметку или папку, переименовать по месту, перетащить мышью в другую папку. Важная деталь: смена папки или заголовка у существующей заметки перемещает сам файл, а не плодит дубликат.

Заголовок — это первая строка

В Notarium нет отдельного поля «Title». Заголовок заметки — её ведущий # H1, то есть первая строка документа. Вы правите её прямо в тексте, как и всё остальное. Новая заметка открывается уже на строке # с курсором на месте заголовка — просто начните печатать.

Если ведущего # H1 нет, заголовком станет первая непустая прозаическая строка — быстрая запись не превращается в базу из «Untitled». А вот если документ открывается структурным блоком (код, список, цитата, таблица, заголовок уровня H2 и ниже) и заголовок так и не задан — заметка не сохранится без заголовка: так первая строка кода не утечёт молча в заголовок.

Заголовок связывает воедино имя файла, поиск, граф и историю — поэтому одна поверхность редактирования вместо разъезжающихся «поле + тело».

Режимы письма

Notarium всегда правит сырой Markdown — единственный источник истины. Как этот текст выглядит, пока вы его правите, задаёт режим письма (личная настройка в Settings → Appearance):

• Source (по умолчанию) — сырой Markdown как есть: моноширинный шрифт, подсветка синтаксиса. Маркеры #, **, []() видны как обычный текст. Для тех, кто работает с источником напрямую.
• WYSIWYM — «что видишь, то и подразумеваешь»: текст стилизован (заголовки крупнее, полужирный жирным, цитаты с фоном), но Markdown-маркеры остаются на экране приглушёнными. Длина строки не меняется, поэтому каретка не «прыгает».

Оба режима правят ту же самую строку и сохраняют её байт-в-байт одинаково — переключение режима не меняет содержимое файла.

Отдельно от режимов работает кнопка Preview в верхней панели: она в любой момент показывает финальный HTML-рендер заметки, не сохраняя. Для длинных текстов есть помощники письма Focus (затемняет всё, кроме активного предложения/строки/абзаца) и Typewriter (держит строку с кареткой по центру).

Связи между заметками

Внутри текста работают wiki-ссылки: [[заголовок заметки]] или [[заголовок|подпись]]. Клик переводит на заметку внутри приложения. Если заметки с таким заголовком нет, Notarium предложит её создать — а на графе связей она будет висеть полым «призрачным» узлом до тех пор.

Сохранение и что на диске

Сохранение — по Ctrl/Cmd+Enter. На диск уходит чистый Markdown без переэкранирования и перенормализации: ровно то, что вы набрали. Имя файла Notarium выводит из заголовка (kebab-case с транслитерацией кириллицы), поэтому файл читается и вне приложения.

В начало файла попадает небольшой frontmatter, и в нём — ключ notarium-id: стабильный 12-символьный идентификатор заметки. Именно он, а не путь и не имя файла, служит настоящей идентичностью: переименование и перенос между папками не рвут ссылки и не теряют историю версий, потому что журнал ведётся по notarium-id.

Каждое сохранение уходит в историю ревизий: полный снапшот состояния заметки с провенансом — кто и как правил (вы, внешний редактор или агент). Любую версию можно посмотреть, сравнить и откатить.

Дальше

• Подключить агента — дать ИИ-агенту писать в ту же базу через MCP.
• Редактор и Горячие клавиши — режимы, форматирование и хоткеи подробно.
• File-first и Версии и история — как устроена модель хранения.