Logseq: локальные заметки и база знаний

Logseq — локальное приложение для заметок, которое хранит данные в обычных Markdown-файлах и строит из них граф связей. Оно подходит для личной базы знаний, дневника задач и проектной документации: записи остаются на диске, их можно читать любым текстовым редактором и версионировать через Git. Ниже — установка, структура графа, ежедневный рабочий процесс и обслуживание хранилища.

Почему локальный формат важен

Большинство заметочников хранят текст в закрытой базе данных. Logseq устроен иначе: страницы лежат в папке графа в виде файлов .md, а служебные настройки — в каталоге logseq. Если приложение перестанет запускаться, заметки всё равно останутся доступными. Это же свойство упрощает резервное копирование и поиск по содержимому обычными средствами Linux.

У формата есть цена: конфликты при одновременном редактировании одного файла и отсутствие «магии» базы данных. Для одного пользователя это почти не заметно, а для совместной работы лучше заранее договориться о разделении страниц.

Установка и создание графа

flatpak install flathub com.logseq.Logseq
flatpak run com.logseq.Logseq
mkdir -p ~/Documents/knowledge-base
cd ~/Documents/knowledge-base && git init

В качестве альтернативы можно скачать AppImage с официального сайта, выдать файлу право на выполнение и запустить. При первом старте Logseq предложит создать граф или открыть существующую папку. Выберите пустой каталог, желательно внутри домашней директории, которую вы уже резервируете.

Сразу после создания графа включите Git: это даст историю изменений и защиту от случайного удаления. Файлы журналов и страниц — обычный текст, поэтому диффы читаются без специальных инструментов.

Структура графа и основные сущности

Внутри папки появятся каталоги pages, journals, assets и служебный logseq. Каждая страница — отдельный Markdown-файл, имя которого связано с заголовком. Журналы создаются по датам, а вложения складываются в assets. Не переименовывайте служебные файлы вручную: для этого есть интерфейс и переиндексация.

• Блок — минимальная единица текста; у него есть собственный идентификатор.
• Страница — именованный узел графа, создаётся ссылкой [[Название]].
• Тег — короткая ссылка вида #проект, удобная для фильтрации.
• Свойство — строка key:: value, по ней можно строить запросы.

Ссылки на блоки работают через ((идентификатор)). В интерфейсе достаточно скопировать ссылку на блок и вставить её в другую заметку. Такой приём удобен для цитирования решений, но злоупотреблять им не стоит: через год вложенные ссылки становятся трудночитаемыми.

Ежедневный рабочий процесс

Начните с журнала: в нём удобно фиксировать встречи, задачи и мысли без предварительной сортировки. Затем разнесите важное по тематическим страницам. Задача оформляется маркером TODO, при необходимости добавляются SCHEDULED и DEADLINE. Планировщик Logseq показывает такие блоки в журнале на нужную дату.

TODO Проверить бэкап базы знаний
SCHEDULED: <2026-11-06 Fri>
DEADLINE: <2026-11-10 Tue>
status:: в работе

Для поиска открытых задач подойдёт простой запрос. Он возвращает блоки, где одновременно есть ссылка на проект и маркер TODO или DOING.

{{query (and [[Проект X]] (task TODO DOING))}}

Шаблоны создаются из готового блока командой /template. В шаблон стоит включать структуру встречи: участники, повестка, решения, следующие шаги. Это экономит время и делает заметки единообразными.

Настройка config.edn

Файл logseq/config.edn управляет поведением графа. Правьте его при закрытом приложении и делайте копию: синтаксическая ошибка может помешать запуску. Ниже — минимальный набор полезных параметров.

{:journal/page-title-format "yyyy-MM-dd"
 :block-hidden-properties #{:created-at :updated-at}
 :feature/enable-block-timestamps? true
 :ui/enable-tooltip? true}

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

Импорт заметок из других приложений

Перенос из другого заметочника редко бывает идеальным. Markdown-файлы можно скопировать в pages, но ссылки и вложения придётся проверить: пути к картинкам часто указывают на старую структуру. Импортируйте небольшими партиями и после каждой проверяйте, что ссылки открываются, а задачи не потеряли маркеры.

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

Резервное копирование и синхронизация

Самый предсказуемый способ синхронизации — Git через собственный сервер или локальный remote. Коммиты делайте после крупных правок, а не каждые пять минут. Для бинарных вложений Git подходит хуже: папка assets быстро растёт, поэтому тяжёлые файлы лучше хранить отдельно.

cd ~/Documents/knowledge-base
git add .
git commit -m "Update notes"
git log --oneline -5

Если нужен автоматический бэкап, используйте tar с датой в имени. Храните копию на другом носителе: архив на том же диске не защищает от отказа оборудования.

mkdir -p ~/backups
tar -czf ~/backups/logseq-$(date +%F).tar.gz -C ~/Documents knowledge-base
ls -lh ~/backups/logseq-*.tar.gz | tail -5

Синхронизация через облачный диск допустима, но требует осторожности: два устройства не должны одновременно писать один и тот же файл. При конфликте Logseq создаёт копию, и её нужно разобрать вручную. Для совместной работы над одной страницей локальный формат подходит плохо.

Поиск, порядок и обслуживание

По графу можно искать без приложения — ripgrep работает быстрее встроенного поиска и показывает контекст. Это полезно при проверке, не осталось ли в заметках паролей или служебных пометок.

rg -n -i "пароль|токен|secret" ~/Documents/knowledge-base/pages
rg -n "TODO" ~/Documents/knowledge-base/pages | wc -l

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

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

Итог

Logseq даёт локальную базу знаний без привязки к чужому серверу: Markdown-файлы, ссылки между блоками, запросы и задачи в одном интерфейсе. Настройте Git и регулярный архив, заведите шаблоны для повторяющихся заметок и не превращайте граф в свалку. Тогда база останется быстрой, читаемой и восстановимой даже без самого приложения.