Прозрачная синхронизация Obsidian между устройствами через GitHub

Гурлев Андрей

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

Главный вопрос для новичков: как синхронизировать эти локальные файлы между разными устройствами? Многие решения платные (официальный Sync) или требуют настройки дополнительных сервисов (iCloud, Dropbox, Syncthing).

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

Автоматическую синхронизацию между Windows, macOS, Linux, Android и iOS.
Полноценную историю изменений всех ваших заметок благодаря Git.
Бесплатное резервное копирование в приватный репозиторий на GitHub.
Работу без сторонних приложений вроде Termux или сложных скриптов.

Шаг 0: Установите Obsidian на все свои устройства

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

Официальный сайт для загрузки: https://obsidian.md/download

Шаг 1: Создаем приватный репозиторий на GitHub

Залогиньтесь на github.com.
Перейдите по ссылке https://github.com/new и заполните форму:
Repository name: Укажите название для вашего хранилища (например, my-obsidian-vault).
Выберите опцию Private (Приватный).
* Поставьте галочку Add a README file (репозиторий не должен быть пустым).
Нажмите зеленую кнопку Create repository.
В корне созданного репозитория нажмите кнопку Add file -> Create new file.
Введите имя файла .gitignore.
В тело файла введите одну строку: .obsidian.
Нажмите Commit new file внизу.

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

Шаг 2: Создаем токен доступа

Чтобы программы могли работать с вашим приватным репозиторием, нужен специальный ключ.

Перейдите по ссылке: https://github.com/settings/tokens/new.
Заполните форму:
Note: Придумайте название для токена (например, Obsidian Sync).
Expiration: Выберите No expiration (Срок не истекает).
* В разделе Select scopes обязательно отметьте галочку repo.
Нажмите зеленую кнопку Generate token внизу.
НЕ ЗАКРЫВАЙТЕ СТРАНИЦУ! Скопируйте и сохраните полученный токен в надежное место (менеджер паролей). GitHub покажет его только один раз.

Шаг 3: Настраиваем синхронизацию на компьютере (Windows/macOS/Linux)

3a: Подготовка и клонирование репозитория

Установите Git, если его еще нет:
Скачайте с официального сайта: https://git-scm.com/downloads
Установите, приняв настройки по умолчанию.
Настройте Git (требуется один раз). Откройте терминал (Командную строку, PowerShell, Terminal) и выполните команды, подставив свои данные:
bash git config --global user.email "ВАШ-EMAIL" git config --global user.name "ВАШЕ-ИМЯ"
Эти данные будут привязываться к вашим коммитам.
Создайте папку, где будут храниться все ваши хранилища Obsidian (например, C:\Obsidian или ~/Documents/Obsidian).
Соберите ссылку для клонирования по шаблону:
https://<ВАШ_ТОКЕН>@github.com/<ВАШ_USERNAME>/<НАЗВАНИЕ_РЕПОЗИТОРИЯ>.git

Пример:
https://ghp_1wKdGc4IhVCHxXEaKClMNp1rEMwsHu1f5zNZ@github.com/myuname/my-obsidian-vault.git

Откройте терминал, перейдите в созданную папку (cd C:\Obsidian) и выполните команду клонирования:
bash git clone https://ghp_...@github.com/...git
В папке появится новая папка с вашим репозиторием (например, my-obsidian-vault).

3b: Подключение хранилища в Obsidian и настройка плагина

Откройте Obsidian.
Выберите Open folder as Vault и укажите путь к только что клонированной папке (my-obsidian-vault).
Перейдите в Настройки (Settings) -> Community plugins и отключите Safe mode.
Нажмите Browse, найдите плагин Obsidian Git и установите его. После установки включите его.
Теперь зайдите в настройки этого плагина (он появится в списке слева) и настройте его:
  Vault Backup Interval (minutes): 1 (Синхронизация каждую минуту)
  Auto backup after file change: Enabled (Синхронизировать после изменений)
  Auto pull on startup: Enabled (Скачивать обновления при запуске)
  Disable notifications: Enabled (Убрать уведомления для тихой работы)
Готово! Плагин будет автоматически фиксировать изменения и синхронизировать их с GitHub каждую минуту и при запуске.

Совет: Для принудительной синхронизации используйте команду через Ctrl+P (Cmd+P на Mac): начните вводить Git: Create backup и нажмите Enter. Этой команде можно назначить горячую клавишу в настройках Obsidian.

Шаг 4: Настраиваем синхронизацию на смартфоне (Android / iOS)

Установите Obsidian из App Store или Google Play.
Откройте приложение и создайте новое пустое хранилище (Vault). Дайте ему такое же имя, как на компьютере.
Внутри мобильного приложения перейдите в Настройки -> Community plugins -> Browse и найдите плагин Fit.
Установите и включите его.
Перейдите в настройки плагина Fit и заполните данные:
  GitHub Access Token: Вставьте токен, сохраненный на Шаге 2.
Нажмите кнопку Authenticate user.
  GitHub repository name: Выберите имя своего репозитория из выпадающего списка.
  Branch name: main.
  Auto sync interval: 1 минута.
  Auto sync: Включите опцию Muted (тихая синхронизация).
*   File change notification: Рекомендуется отключить, чтобы не спамило уведомлениями.
Плагин начнет первоначальную синхронизацию и загрузит все файлы из репозитория в ваше пустое хранилище.

Шаг 5: Техника безопасности и работа с конфликтами

Главное правило: старайтесь не редактировать одну и ту же заметку одновременно на двух устройствах.

На компьютере: Если конфликт все же произошел, плагин Obsidian Git уведомит вас. Конфликт решается стандартными средствами Git (вам нужно будет вручную отредактировать файл, убрав конфликтующие строки). Если изменения были в разных частях файла, Git часто разрешает конфликт автоматически.
На телефоне: Плагин Fit в случае конфликта сохранит вашу локальную версию, а версию с GitHub поместит в специальную папку _fit. Вам нужно будет вручную объединить изменения.

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

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