Приветствую!

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

Подписывайтесь на наш телеграм @r4ven_me📱, чтобы не пропустить новые публикации на сайте😉. А если есть вопросы или желание пообщаться по тематике — заглядывайте в Вороний чат @r4ven_me_chat🧐.

Предисловие

Сразу скажу, что в этой статье не будет пафосных речей, про то, как стать киборгом-рептилоидом и сделать из Obsidian второй-третий-десятый мозг, используя систему Zettelkasten🤷‍♂️. Подобного материала полно на просторах необъятного. В этой заметке я просто расскажу про свой опыт настройки и использования Obsidian в качестве удобного инструмента для ведения своей базы знаний, с доступом к ней с разных устройств, будь то ноутбук💻 или смартфон📱.

⚠️Перед началом важно отметить, что Obsidian —  проприетарное ПО, что не даёт возможности узнать, как именно программа обрабатывает данные. В то же время большая часть расширений (плагинов) Obsidian созданы сообществом и являются open source проектами, исходные коды которых размещены на GitHub.

Честно признаюсь, данное приложение для меня — исключение из правил. Я стараюсь пользоваться открытым ПО, но к сожалению в мире «заметочников» (в т.ч. open source) большой выбор, но в то же время выбирать не из чего. На роль инструмента, который удовлетворил бы все мои хотелки подошёл только Obsidian. Ближайшим аналогом с открытыми исходниками является проект Joplin. Но у него есть несколько критичных для меня косяков. Тем не менее, я длительное время пользовался им и в целом могу рекомендовать👍. Но перейдем к герою сегодняшней статьи📝.

Введение

Obsidian — кросс-платформенное приложение для ведения Markdown-заметок на ПК и мобильных устройствах. Доступное на Linux, Windows, Mac, Android и iOS.

Markdown — облегчённый язык разметки, позволяющий писать «сырой» текст и моментально видеть отрендеренный результат (аналогично HTML, но проще).

💡Хорошим примером применения разметки Markdown (md) является файл README.md, который вы вероятно встречали в различных местах.

Так как цель статьи — рассказать про мой опыт использования Obsidian, то я не буду учить вас разметке Markdown, а просто оставлю ссылку на хорошую шпаргалку из официальной документации GitHub.

На изображении ниже показан пример «сырого» текста и его рендеринга в Obsidian:

💡Obsidian работает с обычными текстовыми файлами, расположенных на вашем диске.

Отличие Obsidian от многих аналогов — рендеринг Markdown в реальном времени. Т.е. вы пишите сырой Markdown текст и он тут же визуализируется.

С назначением программы определились, переходим к установке🛠️.

Установка Obsidian

Как уже ранее сказал, Obsidian доступен для разных платформ. Чтобы скачать установочный файла идём на страницу загрузки официального сайта: https://obsidian.md/download и выбираем подходящий вариант:

💡Установочные файлы также доступны на странице релизов в GitHub репозитории проекта.

В своём примере я покажу, как выполнить установку Obsidian из .deb пакета с помощью терминала в Linux Mint 22:

⚠️Обратите внимание, что для выполнения команд потребуются права sudo.

# скачиваем deb пакет
curl -fsSLO \
    $(curl -s https://api.github.com/repos/obsidianmd/obsidian-releases/releases/latest \
    | grep -o 'https://github.com/obsidianmd/obsidian-releases/releases/download/.*/obsidian_.*_amd64.deb')

# устанавливаем deb пакет
sudo apt install ./obsidian_*_amd64.deb

# удаляем установочный файл
rm -vf ./obsidian_*_amd64.deb

💡В команде curl используется механизм подстановки командной строки. Т.е. основной команде на скачивание: curl -fsSLO передается аргумент, который является результатом выполнения другой команды внутри конструкции $(command), выполняющейся предварительно. В итоге основная команда получит прямой URL на .deb файл последнего релиза Obsidian из GitHub. Команда универсальна.

Первый запуск

После установки программы запускаем её через меню приложений:

⚠️Т.к. Obsidian является закрытым ПО, то рекомендую уделять больше вниманию его поведению, например отслеживать сетевую активность с помощью OpenSnitch:

В стартовом окне вам будет предложено выбрать один из вариантов:

• Quick Start — создать хранилище по пути ~/Документы/Obsidian Vault с примером заметок;
• Create new vault — вручную выбрать имя для хранилища и папку, в которой оно будет находиться;
• Open folder as vault — указать уже существующую папку;
• Sync — платная фирменная облачная синхронизация (нам не интересно);

💡В Obsidian термин vault (хранилище) означает обычную папку, в которой хранятся все файлы: заметки, вложения, настройки программы и плагинов.

Также на этом этапе можно выбрать язык интерфейса — русский доступен. Сделать это можно и в настройках программы (в нижнем левом углу нажмите на шестеренку ⚙️):

Для применения изменений необходимо перезапустить приложение.

💡Подробнее процесс настройки Obsidian можно изучить в официальной документации, также доступной на русском языке: https://publish.obsidian.md/help-ru/.

Итак, перед нами основное окно программы Obsidian: слева древовидная панель с директориями и заметками, справа область редактирования/просмотра заметки. Программа имеет возможность работы с вкладками, а также открытие нескольких заметок рядом друг с другом в разных областях, в которых могут быть свои вкладки:

Далее я покажу свой вариант настройки и использования Obsidian. Начнём с директории для медиа файлов.

Указание директории для хранения вложений

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

Для настройки такого поведения в корне создаём папку, например, с названием _resources:

Затем переходим в настройки программы, в раздел Файлы и ссылки и указываем данную директорию в качестве хранилища вложенных файлов:

Теперь все вложения будут аккуратно храниться в _resources и не создавать визуальный шум во время работы🧑‍💻.

Оформление — тема Nordic

Obsidian поддерживает большой список тем оформления интерфейса. Покажу, как установить мою любимую тему. В настройках переходим в Оформление — Темы — Настроить. В поиске вводим Nordic, затем нажмите Установить и Применить:

Тема поддерживает светлый и тёмный варианты.

Светлая☀️:

И тёмная🌑:

В разделе Оформление можно настроить шрифты, масштабирование, внешний вид рамки и прочие параметры🛠️.

Плагины

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

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

Далее нажимаем Обзор:

Editing toolbar — панель инструментов

В строке поиска вводим название Editing toolbar и нажимаем Установить:

Затем Включить:

Теперь при редактировании заметки в верхней части окна появится панель инструментов для быстрого и удобного форматирования, как в текстовых процессорах:

Такая панель существенно облегчает процесс форматирования текста, особенно новичкам🧑‍🎓.

Tray — системный трей

По умолчанию функционала системного трея в Obsidian нет. Поэтому аналогичным образом ищем плагин в поиске:

Устанавливаем и переходим в Настройки:

Я обычно включаю следующие настройки:

• Запускать Obsidian при старте системы;
• Сворачивать приложение после запуска;
• Работа приложения в фоновом режиме, т.к. сворачивать в трей при закрытии;
• Ну и отображать иконку трея.

В этом разделе можно также задать свою иконку трея, которая у меня в Linux почему-то корректно не отображается🤷‍♂️, поэтому эту опцию я обычно не трогаю.

После активации плагина в системном трее появится иконка Obsidian:

💡Если автозапуск Obsidian при входе в систему у вас не активируется, то вы можете создать специальный .desktop файл в директории ~/.config/autostart самостоятельно такой командой в терминале:

cat << EOF > ~/.config/autostart/obsidian.desktop
[Desktop Entry]
Type=Application
Name=Obsidian
Comment=Запуск Obsidian при старте системы
Exec=obsidian
Terminal=false
X-GNOME-Autostart-enabled=true
X-GNOME-Autostart-Delay=15
EOF

Remotely save — синхронизация с облачным хранилищем

Вся эта затея с заметками не имела смысла, если бы отсутствовала возможность синхронизировать свою базу между разными устройствами🖥️💻📱.

Плагин Remotely save позволяет настроить синхронизацию с облачными хранилищами (Google Drive, Yandex Disk, Nextcloud и пр.), как публичными, так и self hosted. Я покажу пример настройки синхронизации с Yandex Disk по протоколу WebDav.

Устанавливаем сам плагин:

Переходим в настройки и указываем следующие параметры:

• Сервис — Webdav
• Адрес сервера — https://webdav.yandex.ru/
• Имя пользователя — обычно это адрес Email
• Пароль приложения с доступом к файлам по WebDav — как получить читайте тут

При необходимости, в параметре Change The Remote Base Directory можно явно указать удаленную директорию, в которой будут храниться заметки. По умолчанию это Obsidian Vault в корне диска:

По умолчанию в плагине отключена автоматическая синхронизация по интервалу. Включаем её тут:

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

Для проверки подключения запустите синхронизацию вручную, нажав специальную кнопку на боковой панели слева:

В результате вы должны увидеть ваши заметки в облаке:

Альтернативным и предпочтительным для меня способом синхронизации файлов, в т.ч. заметок Obsidian, является синхронизация на уровне файловой системы с помощью программы Syncthing. Но этот пункт выходит за рамки данной статьи, поэтому для интересующихся я просто оставлю ссылку на мою подробную инструкцию: Поднимаем сервер синхронизации файлов Syncthing в docker.

Telegram sync — синхронизация с Telegram

О, это безумно удобный плагин для меня🔥. Обычно я сохраняю все в «Избранное» в Telegram, тем самым превращая данное место в «помойку». С помощью плагина Telegram sync можно с легкостью отправлять нужные посты и сообщения из телеги прямо в Obsidian через чат с вашим ботом.

Схема взаимодействия выглядит следующим образом:

1. выбираете пост/сообщение в телеграм;
2. вызываете контекстное меню;
3. нажимаете Переслать;
4. выбираете чат с вашим ботом;
5. пост/сообщение автоматически пересылается в Obsidian в заранее указанный раздел.

☝️Отправленные в Obsidian заметки автоматически форматируются в Markdown.

⚠️Стоит отметить, что данная синхронизация работает пока Obsidian запущен на вашем ПК, подключённый к интернету. Если Obsidian потеряет связь с ботом, сообщения пересланные более 24 ч. назад в Obsidian не попадут.

Как вы уже наверное догадались для реализации такой схемы вам потребуется токен вашего бота в телеге и Telegram ID аккаунта (или ID любого чата, в котором будет ваш бот).

Под спойлером короткая инструкция, как получить необходимые данные.

И так у нас есть токен бота и Telegram ID. Теперь уже обычным для нас способом находим и устанавливаем плагин Telegram Sync, затем идём в Настройки плагина:

Тут переходим в настройки бота:

И указываем токен бота и ID вашего аккаунта (или нужного чата). Не забываем подтвердить:

Через несколько секунд Obsidian должен подключиться к вашему боту. Успешное соединение выглядит так:

Также в настройках Telegram Sync я настраиваю ещё два параметра:

1) В Advanced settings включаю опцию удаления пересланного сообщения после его сохранения в Obsidian (чтобы не засорять чат):

2) В разделе Message distribution rules меняю шаблон имени и путь заметок, параметр: Templeate file path:

По сути просто убираю дату из шаблона имени заметки:

Telegram/{{content:30}}.md

Для проверки перешлите любое сообщение в чат с вашим ботом:

По умолчанию в Obsidian создается раздел Telegram, в который складываются пересланные заметки:

С плагинами закончили, переходим к расширениям браузера🌐.

Расширения для браузера

Я рекомендую 2 расширения:

1. Web Clipper — официальное расширение от разработчиков, которое позволяет сохранять страницы сайтов сразу в Obsidian в формате Markdown;
2. Copy as Markdown — это универсальное расширение, позволяющее копировать выделенный фрагмент страницы в буфер обмена, при этом форматируя его в Markdown.

Оба расширения очень полезны, но в своей практике я больше пользуюсь вторым, т.к. мне не часто приходится сохранять что-то в браузере и не всегда в Obsidian.

Но начнём по порядку.

Obsidian Web Clipper

Идём на страницу загрузок Obsidian, прокручиваем страницу в самый низ и переходим по ссылке в магазин расширения вашего барузера. Я покажу на примере Chromium. Нажимаем Установить:

Теперь просто переходим на нужную вам страницу в интернете, далее нажимаем на кнопку самого расширения и после Добавить в Obsidian:

При первом использовании браузер покажет уведомление. Ставим чекбокс, чтобы не видеть его постоянно и затем нажимаем Открыть приложение «Obsidian»:

Откроется сохраненная заметка в формате Markdown с отображением некоторых метаданных (их можно отключить в настройках расширения):

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

И перезапустите браузер.

Сохранять заметки можно также через контекстное меню:

Если не нужно сохранять страницу целиком, просто выделите нужный фрагмент, нажмите ПКМ и точно также выберите Save this page.

Copy as Markdown

Тут всё примерно также: переходим на страницу расширения и устанавливаем его:

Теперь при выделении текста на странице в контекстном меню через ПКМ будет доступна кнопка Copy selection as Markdown:

Теперь открываем нужную заметку в Obsidian и просто вставляем с помощью Ctrl+v:

Удобно? Еще бы.

Послесловие

Надеюсь моя статья оказалась для вас полезной.

Я долгое время искал подходящий инструмент для ведения своей базы знаний. Чаще всего это заметки по IT тематике. Мне очень важны удобство, внешний вид, стабильность и широкий функционал. Перепробовал множество разных Open source решений. У каждого были свои плюсы, но чего-то всегда не хватало: то синхронизация криво работает, то ограниченные настройки или просто отсутствует порт программы для смартфона.

Я искал универсальное решение. И Obsidian оказался редким исключением, хоть и проприетарным. Он одинаково хорошо работает и на ПК, и на смартфоне. Довольно гибкие настройки + множество плагинов сообщества. Это не «волшебная палочка», но на данный момент — самое удобное решение из того, что я пробовал.

В качестве доп. материала рекомендую посмотреть пару видео про Obsidian:

• Философия и практика Obsidian — организация знаний и жизни | YouTube
• Лучшие плагины для Obsidian и правильная структура базы за 2 года работы | YouTube

На этом всё. Спасибо, что читаете!

Полезные материалы

• Страница загрузок Obsidian | Официальный сайт
• Страница релизов | GitHub
• Расширение Obsidian Web Clipper | Chrome
• Расширение Copy as Markdown | Chrome
• Документация по разметке Markdown | GitHub
• Официальная документация по Obsidian
• Другие полезные программы для Linux Power User