Справочник

Как работает импорт

Что принимает импорт, лимиты на размер, какие поля frontmatter он читает, его параметры и что бывает со ссылками и удалёнными заметками.

Импорт — в разделе Настройки › Заметки › Импорт или по кнопке Импортировать на пустом экране Заметки. Перетащи или выбери файлы Markdown (.md, .markdown) и текстовые файлы (.txt) или ZIP-архив с папкой. Каждый файл становится одной заметкой со статусом «Проверена».

Что принимается

ZIP-архив — до 32 МБ и до двух тысяч файлов и папок внутри. Распакованный объём тоже ограничен, считая скрытые и неподдерживаемые файлы: по умолчанию это 100 МБ. Если после импорта архива заметок в memex станет больше лимита, архив отклоняется целиком, ещё до того, как что-то запишется. Подробнее — Чего memex не делает.

Файл больше лимита на текст заметки (по умолчанию 2 МБ вместе с frontmatter) пропускается, и memex показывает его имя. Если файл не в UTF-8 или его frontmatter использует якоря и алиасы YAML (&name, *name), вложен глубже 128 уровней или весит больше 64 КБ, отклоняется весь ZIP-архив, ещё до того, как что-то запишется. Отдельные файлы без архива проверяются по одному: подходящие сохраняются, а про каждый неподходящий memex скажет, что это за файл и почему его не взяли. Оба лимита действуют для любого аккаунта, даже если в нём добавлен свой ключ.

Сами папки, а также скрытые файлы и папки (.obsidian в хранилище Obsidian, папка .git) пропускаются молча, а всё, что не текст, пропускается, и memex показывает имена таких файлов. Больше ничего, в том числе PDF и картинки, импорт не принимает.

Frontmatter

Поля frontmatter title, tags (список или строка через запятую), aliases, summary, summary_by (кто написал описание), source_url, created и updated становятся собственными полями заметки, а любой другой ключ — её свойством, со значением как есть. Строки source и status из экспорта старых версий memex не переносятся. aliases — псевдонимы заметки, как в Obsidian: ссылка по любому из них ведёт к ней. Дата без часового пояса (так их пишет Obsidian) считается датой по UTC, а дата в будущем не учитывается. Если у файла нет заголовка, заголовком становится имя файла.

Параметры

Для ZIP-архивов есть два параметра: Пропускать заметки, если такой заголовок уже есть (включён по умолчанию) и Превращать папки верхнего уровня в теги, а ещё поле для дополнительных тегов, которые получит всё импортированное. Проверить архивы сначала показывает, что будет создано, а что пропущено; Импортировать запускает импорт.

Ссылки и удалённые заметки

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