# Как устроена заметка

> Из чего состоит заметка, как работают ссылки и обратные ссылки, что о ней записывается и как она появляется.

Страница: https://docs.memex.tools/ru/how-notes-work

У заметки есть заголовок, текст, теги, свойства, описание, ссылки, статус и история. Каким бы путём заметка ни появилась, дальше она такая же, как все остальные.

## Из чего состоит заметка

| Часть | Что это |
|---|---|
| **Заголовок** | Обязателен, до 500 символов. Заголовки могут повторяться, но ссылки между заметками находят заметку по заголовку, поэтому чем точнее заголовок, тем надёжнее связи. |
| **Текст** | Markdown. Заголовки, списки, таблицы, блоки кода, списки задач и ссылки отображаются как надо. Всё, что можно хранить в файле Markdown, можно хранить и в заметке. |
| **Теги** | Простой список слов в нижнем регистре. Папок и вложенных тегов нет. Три тега особые: `skill`, `live-state` и `user-profile`. Подробнее: [Как работают навыки](https://docs.memex.tools/ru/how-skills-work). |
| **Свойства** | Именованные факты рядом с текстом, как свойства в Obsidian: `status: active`, `due: 2026-11-01`, `client: Acme`. Значение — это текст, число, «да» или «нет», список или несколько значений под одним именем. Их задаёт тот, кто пишет заметку: ассистент, frontmatter импортированного файла или ты в редакторе. Сам memex их никогда не заполняет. Ассистент умеет искать заметки по свойствам. |
| **Описание** | Два-три предложения о том, что в заметке, чтобы человек или ассистент мог решить, открывать ли её. В инструментах для ассистентов оно называется *summary*. Ассистент пишет его, когда сохраняет заметку, а ты можешь его изменить. Для того, что ты добавляешь на сайте, описание может написать memex на твоём собственном ключе, если это включить. |
| **Статус** | *Проверена* или *на проверке*. Подробнее: [Как работает проверка](https://docs.memex.tools/ru/review-gate). |

## Вики-ссылки и обратные ссылки

Напиши `[[Title of another note]]` в любом месте текста или `[[Title|shown text]]`, чтобы вместо заголовка показать другие слова. Ссылка ведёт на заметку с таким заголовком, регистр не важен; подойдёт и имя файла или путь к папке из импортированного хранилища. Ссылка на заметку, которой ещё нет, остаётся как есть и заработает, как только появится заметка с таким заголовком. Ссылки внутри блоков кода — это не ссылки.

Если переименовать заметку, ссылки на неё сохранятся. Ссылка со старым заголовком по-прежнему ведёт на заметку, а при наведении на неё виден нынешний заголовок. Если потом создать заметку со старым заголовком, эти ссылки перейдут к ней, потому что текущий заголовок важнее. То же происходит при объединении: со старым заголовком заметки, которую влили в другую.

Веб-адрес заметки или её номер — не ссылка: и то и другое привязано к одному аккаунту, поэтому при экспорте или переносе они перестают работать.

У каждой заметки есть блок **Обратные ссылки**: какие другие заметки ссылаются на неё.

## Происхождение

Memex записывает, как заметка появилась: написана здесь, импортирована из файла, написана ассистентом или самим memex — так появляются только приветственные заметки. Он хранит адрес источника, если автор его указал, а ещё кто добавил заметку и кто последним её изменил. Каждый автор подписан: человек — именем, ассистент — названием и значком своего подключения, а сам memex — когда он написал описание.

## История

Каждое изменение заголовка, текста, тегов, свойств или описания сохраняется как версия. Открой историю, посмотри, что изменилось, и восстанови любую прежнюю версию. Для каждой заметки хранятся двадцать последних версий.

## Номер и адрес

Заметки нумеруются внутри базы знаний в порядке создания, и номер никогда не используется повторно. Адрес заметки — `https://memex.tools/<your handle>/notes/<number>`, где вместо `<your handle>` стоит идентификатор: код из двенадцати символов, который обозначает твою базу знаний и никогда не меняется. Ассистенты называют заметки по тем же номерам.

> **memex на своём сервере**
>
> Адрес заметки начинается с адреса самого сервера, например `http://localhost:8080`.

## Источники

Заметка может заканчиваться разделом *Sources*: списком ссылок на то, что находится вне memex и определяет содержание заметки, — документацию сервиса, стандарт или страницу, которую ассистент читал, пока писал заметку. У каждой ссылки — пара слов о том, зачем она нужна и когда её перечитывать.

Это договорённость, а не отдельное поле: заголовок `## Sources` и список под ним. Поэтому раздел экспортируется вместе с заметкой, и написать его можно в любом редакторе. Ассистентам говорят, сохраняя заметку, записывать под этим заголовком источники, которыми они пользовались, и перечитывать источники заметки, прежде чем действовать по ней.

Это не то же самое, что происхождение: адрес источника говорит, откуда заметка взялась, а *Sources* — что почитать дальше.

## Три способа добавить заметку

Вполне можно пользоваться только одним из них.

1. **Её пишет ассистент.** Ты говоришь: «Сохрани это в memex», и подключённый ассистент создаёт заметку. По умолчанию она приходит во «Входящие» со статусом *на проверке* и становится частью базы знаний, когда ты её одобришь.
2. **Ты пишешь её в memex.** **Новая заметка** открывает редактор с панелью форматирования, предпросмотром на лету и автодополнением ссылок. Заметки, написанные тобой, сразу становятся проверенными. Подробнее: [Как устроен редактор](https://docs.memex.tools/ru/editor).
3. **Ты загружаешь файлы или целое хранилище.** Файлы Markdown и текстовые файлы, по одному или ZIP-архивом папки — например, хранилища Obsidian. Заголовки и теги из frontmatter учитываются, а ссылки между импортированными заметками работают. Подробнее: [Как работает импорт](https://docs.memex.tools/ru/how-import-works).

Сам memex ничего не скачивает из интернета. Страницу, которую нужно сохранить, читает и сохраняет ассистент. Как это делать, ему объясняет встроенный навык `memex-writing`: указать источник и ссылку, написать, зачем страницу сохранили, и отметить, какую её часть он на самом деле прочитал. С PDF и презентациями — так же.

## По теме

- [Написать заметку](https://docs.memex.tools/ru/write-a-note): Создай заметку, свяжи её с другими, отмени изменение или начни с файла.
- [Как работает проверка](https://docs.memex.tools/ru/review-gate): Что происходит с новыми заметками, правками, замечаниями, удалениями и объединениями от ассистента — и единственная роль, которая обходит часть проверки.
- [Как работают поиск и список заметок](https://docs.memex.tools/ru/how-search-works): Как поиск сочетает точные слова и смысл, операторы поиска, фильтры, рабочие пространства и сам список.
- [Импортировать заметки](https://docs.memex.tools/ru/import): Перенеси в memex файлы Markdown или TXT либо ZIP-архив папки, например хранилища Obsidian.