Синхронизация заметок Obsidian через GitHub

В условиях турбулентной схемы работы облачных сервисов (скажем это так) вопрос хранения и синхронизации личных заметок приобретает особую актуальность. Данная заметка посвящена настройке синхронизации заметок Obsidian между устройствами iOS (Android пока не пробовал) и MacOS с использованием приватного репозитория GitHub (пока как он ещё работает). Позже дополню с переходом на свой git-сервер, но это решение мне ещё надо обкатать.

Что у нас из плюсов?

• Отсутствие зависимости от iCloud (есть только зависимость от GitHub);
• Бесплатность;
• Автоматическое копирование как содержимого заметок, так и истории их изменений;
• Есть и локальное хранение данных, мы же делаем git pull

Краткое описание, что нам нужно

1. Приватный репозиторий GitHub в качестве центрального хранилища.
2. Obsidian собственно.
3. Для десктопных платформ: плагин Git для Obsidian.
4. Для мобильных платформ: плагин Fit для Obsidian.

Установка Obsidian на устройства

Все ссылки под все платформы:
https://obsidian.md/download

Создание приватного репозитория на GitHub

1. Авторизуйтесь на github.com.
2. Перейдите по ссылке https://github.com/new и укажите:
• Имя репозитория;
• Тип доступа: Private;
• Опция: Add a README file (репозиторий не должен быть пустым).
3. Нажмите кнопку создания репозитория.
4. В корне репозитория создайте файл .gitignore со следующим содержимым:.obsidian

Файл .gitignore необходим для исключения папки .obsidian из синхронизации. В данной папке хранятся локальные настройки Obsidian, которые могут конфликтовать при синхронизации между разными устройствами.

Создание токена доступа

1. Перейдите по ссылке https://github.com/settings/personal-access-tokens.
2. Укажите параметры токена:
• Token name (произвольное и понятное вам);
• Expiration: можно No expiration, но осторожно;
• Repository access: Выберите свой репозиторий, который создали ранее.
• Permissions: Выберите всё, что связано с репой, без всяких Copilot и пр.
3. Создайте токен.
4. Скопируйте и сохраните сгенерированный токен

Настройка синхронизации на десктопной платформе

Клонирование репозитория

1. Убедитесь, что в системе установлен Git и он настроен
2. Создайте папку для хранения хранилища Obsidian
3. Откройте терминал, перейдите в созданную папку и выполните клонирование:cd ./OBSIDIANREPO git clone git@github.com:username/ObsidianRepo.git

Создание хранилища в Obsidian

1. Запустите Obsidian.
2. Выберите опцию Open folder as vault и укажите путь к клонированной папке репозитория.
3. Теперь вы можете создавать и редактировать заметки в данном хранилище.

Настройка плагина Git для автоматической синхронизации

1. В настройках Obsidian перейдите в раздел Community plugins, отключите Restricted mode(если активен), найдите и установите плагин Git.
2. В настройках плагина укажите следующие параметры:

• Author name for commit: Ваше имя для коммитов
• Author email for commit: Ваша имя для коммитов Остальные параметры на ваш вкус.

Настройка синхронизации на мобильных устройствах

1. Запустите приложение Obsidian на iOS.
2. Создайте новое пустое хранилище (не добавляйте в него пока файлы).
3. В настройках приложения перейдите в раздел Community plugins, найдите и установите плагин Fit.
4. В настройках плагина укажите:
• Token: вставьте Personal Access Token, созданный ранее;
• Нажмите Authenticate user (она вверху) для авторизации;
• Github repository name: выберите ваш репозиторий;
• Branch name: main;
• Auto sync: Muted;
• Auto check interval: 5 minute;
• File change: отключите все визуальные уведомления.

Особенности плагина Fit и вообще всей связки

• Плагин не поддерживает автосинхронизацию при запуске приложения. Для немедленного получения изменений используйте кнопку Fit Sync (иконка с котиком в меню бургерном) сразу после запуска Obsidian.
• Не редактируйте один и тот же файл одновременно на двух устройствах, если не умеете разбираться с конфликтами в Git

Итоги

Ну как-то так.