Заметки и папки

Импортируйте папки Markdown и хранилища Obsidian, читайте документы и пишите заметки о людях.

Эта страница поможет перенести ваши заметки в Memo и вести там собственные заметки. Вы можете добавить папку с файлами Markdown или папку Obsidian, искать в её документах и писать заметки о людях, сообщениях и проектах. Memo только читает ваши папки: он записывает файл, только когда вы экспортируете свои заметки.

Есть два вида заметок:

  • Заметки из ваших файлов. Memo читает их из папки, которую вы выбрали. Чтобы изменить такую заметку, отредактируйте файл и снова выполните импорт. Их ссылки на источник выглядят как document:3.
  • Заметки, которые вы пишете в Memo. Они хранятся в локальном хранилище и могут касаться человека, сообщения, проекта или другой заметки. Их ссылки на источник выглядят как note:12.

Добавьте папку

Это может быть любая папка с заметками на вашем компьютере: заметки по проекту, папка с документами или папка Obsidian. Memo читает саму папку и все вложенные в неё папки.

Проще всего попросить агента.

Запрос
Use memo CLI to add my notes folder at /path/to/notes and import it.
Tell me how many notes it found and which files it could not read.

Или выполните команды сами. Замените /path/to/notes на полный путь к вашей папке.

Для папки с обычными файлами Markdown:

memo folders add /path/to/notes --format markdown
memo notes import --no-embed

Для папки Obsidian:

memo folders add /path/to/vault --format obsidian
memo notes import --no-embed

memo folders add выводит ID папки, например 1. memo notes import читает заметки и сообщает, сколько их нашлось:

/path/to/notes: 24 notes, 24 changed, 0 moved, 0 gone

--no-embed пропускает подготовку к поиску по смыслу, поэтому для начала работы модель поиска не нужна. Запускайте memo notes import снова после того, как добавите или измените файлы; читаются только изменения.

Можно добавить несколько папок. memo folders list показывает их все.

Markdown или Obsidian

Формат сообщает Memo, как в ваших заметках записаны ссылки и теги. Чтобы пользоваться Memo, Obsidian не нужен, и Obsidian не обязательно держать открытым.

Обязательностьmarkdownobsidian (по умолчанию)
Ссылки на другие заметкиСсылки Markdown на файл (см. ниже)[[Other note]], [[Other note|label]], а также с #heading
Тегиполе tags: в начале файлаполе tags: и #tags в тексте
Другие названия заметкиполе aliases:

Ссылка в папке формата markdown выглядит так:

[label](other-note.md)

В папке формата markdown слово #word в тексте не считается тегом. Оба формата понимают ссылки, записанные как ссылки на источник, например [Kai](person:7) или просто msg:telegram/1/77/42.

Папка Obsidian (vault) — это папка с заметками Markdown, которую Obsidian открывает как одно рабочее пространство. Memo пропускает скрытые папки, например .obsidian.

Файлы, которые читает Memo

ФайлыРасширенияЧто сохраняет Memo
Текст и Markdown.txt, .md, .markdownТекст, ссылки и теги
Таблицы.csv, .tsv, .xlsx, .odsЗначения ячеек с листом, строкой и столбцом
Документы, презентации и электронные книги.odt, .pptx, .epubТекст без оформления
PDF и Word.pdf, .docxТекст с номерами страниц PDF. Нужны дополнительные программы чтения (см. ниже)

Чтобы читать файлы PDF и Word, установите рядом с Memo две дополнительные программы чтения:

npm install -g unpdf mammoth

Некоторые файлы прочитать нельзя: отсканированные PDF (изображения страниц без текста), старые файлы .doc и .xls, а также файлы больше 50 МБ. Memo сохраняет до 200 000 символов из каждого файла. В отчёте об импорте перечислены все файлы, которые не удалось прочитать, и причина, поэтому пропавший файл никогда не выпадает из поиска незаметно.

Пропустите некоторые файлы

Чтобы не пускать некоторые файлы в Memo, перечислите их в notes.ignore в файле настроек. Правило — это путь внутри папки, папка (всё в ней пропускается) или шаблон:

{ "notes": { "ignore": ["Journal/Private.md", "Archive", "**/Private*"] } }

memo notes import --ignore Drafts пропускает папку только при одном импорте.

Найдите свои заметки

memo search notes 'budget'
memo search notes 'budget' --tag work
memo notes show document:3

Каждый результат показывает файл и первую подходящую строку. memo notes show показывает одну заметку с её тегами, заметками, на которые она ссылается, и заметками, которые ссылаются на неё. Другие слова для поиска описаны в разделе Поиск.

Пишите свои заметки

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

Запрос
Use memo CLI to save a note that Kai Sample prefers morning meetings, linked to Kai on Telegram.
Show me the saved note.

Или сами:

memo notes add 'Prefers morning meetings' --about telegram:'Kai Sample'
memo notes list --about telegram:'Kai Sample'

--about указывает, к чему относится заметка. Чтобы указать несколько, повторите его:

К чему относитсяЧто написать
Человек в мессенджереtelegram:'Kai Sample', max:'Kai Sample' или email:[email protected] (имя или ID)
Одно сообщениеего ссылка на источник, например msg:telegram/1/77/42
Заметка или файлnote:12 или document:3
Человек, организация, проект или задачаperson:…, organization:…, project:…, task:…

Копируйте ссылки на источник из результатов поиска; не вводите их по памяти. Человек, сообщение или заметка уже должны быть в локальном хранилище.

Прочитайте, измените или удалите заметку

memo notes show note:12
memo notes edit 12 --revision 1 --text 'Prefers early morning meetings'
memo notes remove 12

У каждой заметки есть номер ревизии, который растёт с каждой правкой. memo notes edit запрашивает текущую ревизию, её показывает memo notes show note:12 --json. Если за это время заметку изменил кто-то другой или другая программа, номера не совпадут и Memo откажется вносить правку, поэтому ни одно изменение не потеряется. Прочитайте заметку снова и повторите.

Заметку из файла редактируют в самом файле, а не через memo notes edit.

Сохраните заметки в файлы

memo notes export --to /path/to/vault/memo --format obsidian

Экспорт записывает заметки, которые вы написали в Memo, в виде файлов Markdown в выбранную вами папку. Для обычного Markdown используйте --format markdown. В начале каждого файла появляются memo-id и memo-hash, поэтому при импорте этой папки одна и та же заметка не создаётся дважды. Если вы сами изменили экспортированный файл, Memo его не перезаписывает и сообщает вам об этом. Чтобы экспортировать заметку сразу при её записи, добавьте --export к memo notes add или memo notes edit.

Главная заметка о человеке

Вы можете указать Memo, какой файл — главная заметка о человеке, например People/Kai.md в вашей папке Obsidian:

memo note telegram:'Kai Sample' /path/to/vault/People/Kai.md
memo note telegram:'Kai Sample'           # shows which note it is
memo note telegram:'Kai Sample' --clear   # forgets it

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

Те же заметки на другом компьютере

Если ваши заметки синхронизируются с другим компьютером, подключите там тот же ID папки вместо того, чтобы добавлять новую папку:

memo folders list                                  # shows the folder IDs the local store has
memo folders attach 1 /other/path/to/notes

С тем же ID заметки сохраняют свои ссылки и теги на обоих компьютерах.

Дальше: пометьте заметки тегами или найдите их.