Справочник
Как устроена заметка
Из чего состоит заметка, как работают ссылки и обратные ссылки, что о ней записывается и как она появляется.
У заметки есть заголовок, текст, теги, свойства, описание, ссылки, статус и история. Каким бы путём заметка ни появилась, дальше она такая же, как все остальные.
Из чего состоит заметка
| Часть | Что это |
|---|---|
| Заголовок | Обязателен, до 500 символов. Заголовки могут повторяться, но ссылки между заметками находят заметку по заголовку, поэтому чем точнее заголовок, тем надёжнее связи. |
| Текст | Markdown. Заголовки, списки, таблицы, блоки кода, списки задач и ссылки отображаются как надо. Всё, что можно хранить в файле Markdown, можно хранить и в заметке. |
| Теги | Простой список слов в нижнем регистре. Папок и вложенных тегов нет. Три тега особые: skill, live-state и user-profile. Подробнее: Как работают навыки. |
| Свойства | Именованные факты рядом с текстом, как свойства в Obsidian: status: active, due: 2026-11-01, client: Acme. Значение — это текст, число, «да» или «нет», список или несколько значений под одним именем. Их задаёт тот, кто пишет заметку: ассистент, frontmatter импортированного файла или ты в редакторе. Сам memex их никогда не заполняет. Ассистент умеет искать заметки по свойствам. |
| Описание | Два-три предложения о том, что в заметке, чтобы человек или ассистент мог решить, открывать ли её. В инструментах для ассистентов оно называется summary. Ассистент пишет его, когда сохраняет заметку, а ты можешь его изменить. Для того, что ты добавляешь на сайте, описание может написать memex на твоём собственном ключе, если это включить. |
| Статус | Проверена или на проверке. Подробнее: Как работает проверка. |
Вики-ссылки и обратные ссылки
Напиши [[Title of another note]] в любом месте текста или [[Title|shown text]], чтобы вместо заголовка показать другие слова. Ссылка ведёт на заметку с таким заголовком, регистр не важен; подойдёт и имя файла или путь к папке из импортированного хранилища. Ссылка на заметку, которой ещё нет, остаётся как есть и заработает, как только появится заметка с таким заголовком. Ссылки внутри блоков кода — это не ссылки.
Если переименовать заметку, ссылки на неё сохранятся. Ссылка со старым заголовком по-прежнему ведёт на заметку, а при наведении на неё виден нынешний заголовок. Если потом создать заметку со старым заголовком, эти ссылки перейдут к ней, потому что текущий заголовок важнее. То же происходит при объединении: со старым заголовком заметки, которую влили в другую.
Веб-адрес заметки или её номер — не ссылка: и то и другое привязано к одному аккаунту, поэтому при экспорте или переносе они перестают работать.
У каждой заметки есть блок Обратные ссылки: какие другие заметки ссылаются на неё.
Происхождение
Memex записывает, как заметка появилась: написана здесь, импортирована из файла, написана ассистентом или самим memex — так появляются только приветственные заметки. Он хранит адрес источника, если автор его указал, а ещё кто добавил заметку и кто последним её изменил. Каждый автор подписан: человек — именем, ассистент — названием и значком своего подключения, а сам memex — когда он написал описание.
История
Каждое изменение заголовка, текста, тегов, свойств или описания сохраняется как версия. Открой историю, посмотри, что изменилось, и восстанови любую прежнюю версию. Для каждой заметки хранятся двадцать последних версий.
Номер и адрес
Заметки нумеруются внутри базы знаний в порядке создания, и номер никогда не используется повторно. Адрес заметки — https://memex.tools/<your handle>/notes/<number>, где вместо <your handle> стоит идентификатор: код из двенадцати символов, который обозначает твою базу знаний и никогда не меняется. Ассистенты называют заметки по тем же номерам.
Источники
Заметка может заканчиваться разделом Sources: списком ссылок на то, что находится вне memex и определяет содержание заметки, — документацию сервиса, стандарт или страницу, которую ассистент читал, пока писал заметку. У каждой ссылки — пара слов о том, зачем она нужна и когда её перечитывать.
Это договорённость, а не отдельное поле: заголовок ## Sources и список под ним. Поэтому раздел экспортируется вместе с заметкой, и написать его можно в любом редакторе. Ассистентам говорят, сохраняя заметку, записывать под этим заголовком источники, которыми они пользовались, и перечитывать источники заметки, прежде чем действовать по ней.
Это не то же самое, что происхождение: адрес источника говорит, откуда заметка взялась, а Sources — что почитать дальше.
Три способа добавить заметку
Вполне можно пользоваться только одним из них.
- Её пишет ассистент. Ты говоришь: «Сохрани это в memex», и подключённый ассистент создаёт заметку. По умолчанию она приходит во «Входящие» со статусом на проверке и становится частью базы знаний, когда ты её одобришь.
- Ты пишешь её в memex. Новая заметка открывает редактор с панелью форматирования, предпросмотром на лету и автодополнением ссылок. Заметки, написанные тобой, сразу становятся проверенными. Подробнее: Как устроен редактор.
- Ты загружаешь файлы или целое хранилище. Файлы Markdown и текстовые файлы, по одному или ZIP-архивом папки — например, хранилища Obsidian. Заголовки и теги из frontmatter учитываются, а ссылки между импортированными заметками работают. Подробнее: Как работает импорт.
Сам memex ничего не скачивает из интернета. Страницу, которую нужно сохранить, читает и сохраняет ассистент. Как это делать, ему объясняет встроенный навык memex-writing: указать источник и ссылку, написать, зачем страницу сохранили, и отметить, какую её часть он на самом деле прочитал. С PDF и презентациями — так же.