---
title: "Первая заметка"
description: "Создать первую заметку в веб-редакторе: дерево файлов, заголовок как первая строка и сохранение обычным .md-файлом на диске."
---

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

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

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

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

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

> [!note] Пустые папки — полноценные
> Папка не исчезает, когда из неё убрали последнюю заметку. Структуру можно готовить заранее.

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

В 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`.

> [!tip] Правки снаружи — нормальный режим
> Отредактировали `.md`-файл в другом редакторе или подтянули из git — Notarium подхватит изменения при следующем сканировании. Файлы остаются источником истины; индекс просто пересобирается под них.

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

## Дальше

- [Подключить агента](/docs/getting-started/connect-agent/) — дать ИИ-агенту писать в ту же базу через MCP.
- [Редактор](/docs/guides/editor/) и [Горячие клавиши](/docs/guides/hotkeys/) — режимы, форматирование и хоткеи подробно.
- [File-first](/docs/concepts/file-first/) и [Версии и история](/docs/concepts/versioning/) — как устроена модель хранения.