DevTrends Logo

Obsidian Releases — Нервный центр расширений для вашего цифрового мозга

31 May, 2026
⭐ 18,283 🔱 6,982 👥 137

Знакомая ситуация: вы нашли идеальный инструмент для работы с заметками, базой знаний или просто для организации мыслей. Он хорош, но чего-то не хватает. Хочется добавить свою фичу, изменить внешний вид или интегрировать его с чем-то еще. И тут возникает вопрос: а как это сделать, если сам инструмент не open-source?

Для пользователей Obsidian, одного из самых популярных и гибких инструментов для работы с информацией, ответ кроется в репозитории obsidianmd/obsidian-releases. Это не просто хранилище файлов, это настоящий хаб, который связывает основное приложение с огромным и постоянно растущим сообществом разработчиков плагинов и дизайнеров тем. Давайте разберемся, почему этот репозиторий — ключ к безграничным возможностям Obsidian.

Не просто код, а целая экосистема

Сразу оговорюсь: если вы надеялись найти здесь исходный код самого Obsidian, то вынужден вас разочаровать. Obsidian — проприетарное ПО, и его исходники хранятся в другом месте. Однако obsidianmd/obsidian-releases играет не менее, а может быть, даже более важную роль для тех, кто хочет активно участвовать в развитии платформы.

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

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

Реклама

Как это работает: Путь вашего плагина к миллионам

Представьте, что вы написали крутой плагин для Obsidian. Как сделать так, чтобы о нем узнали и начали использовать? Именно здесь на сцену выходит obsidianmd/obsidian-releases.

Централизованный каталог: Ваш плагин на витрине

Репозиторий содержит два ключевых JSON-файла: community-plugins.json для плагинов и community-css-theme.json для тем. Эти файлы — не что иное, как списки всех доступных расширений. Когда вы открываете браузер плагинов или тем в Obsidian, приложение обращается именно к этим спискам, чтобы показать вам актуальный ассортимент.

Чтобы ваш плагин или тема попали в этот список, нужно сделать Pull Request в соответствующий JSON-файл. Конечно, есть определенные правила и формат, но об этом чуть позже. Главное — это централизованный и прозрачный механизм добавления контента.

От идеи до установки: Жизненный цикл плагина

Давайте посмотрим, как Obsidian "подтягивает" плагины:

  1. Обнаружение: Obsidian читает community-plugins.json, чтобы получить базовую информацию: id, name, author, description и repo (ссылка на ваш GitHub-репозиторий). Эти поля используются для поиска и отображения в каталоге.
  2. Детализация: Когда пользователь кликает на ваш плагин, Obsidian идет в ваш репозиторий на GitHub и забирает manifest.json и README.md. README.md отображается как описание плагина, а manifest.json нужен для определения последней версии и совместимости.
  3. Загрузка: Самое интересное! Когда пользователь нажимает "Установить", Obsidian ищет в вашем репозитории на GitHub релизы (GitHub Releases), помеченные тем же тегом, что и версия в вашем manifest.json. Затем он скачивает оттуда manifest.json, main.js, и, если есть, styles.css. Эти файлы помещаются в нужную папку внутри хранилища Obsidian.

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

Что нужно для публикации плагина или темы?

Если вы готовы поделиться своим творением, вот что вам понадобится:

Для тем (community-css-theme.json):

{
  "name": "Уникальное имя вашей темы",
  "author": "Ваше имя",
  "repo": "user-name/repo-name",
  "screenshot": "path/to/screenshot.png",
  "modes": ["dark", "light"], // или ["dark"] / ["light"]
  "publish": true // если тема совместима с Obsidian Publish
}

Кстати, для тестирования тем с Obsidian Publish есть удобные функции applyCss и applyCssByLink в консоли разработчика, которые позволяют загружать CSS прямо на тестовый сайт. Очень удобно, чтобы не владеть собственным сайтом Publish для отладки!

Для плагинов (community-plugins.json):

{
  "id": "уникальный-id-плагина",
  "name": "Название плагина",
  "author": "Ваше имя",
  "description": "Краткое описание того, что делает ваш плагин.",
  "repo": "user-name/repo-name"
}

Тестирование и анонсы: Расскажите о себе!

Прежде чем ваш плагин попадет в официальный каталог, вы можете провести бета-тестирование. Для этого очень пригодится плагин BRAT (Beta Reviewer's Auto-update Tool). Он значительно упрощает установку тестовых версий для ваших бета-тестеров.

После того как ваш плагин или тема будут одобрены и добавлены в каталог, не забудьте рассказать о них! Официальные каналы для анонсов — это форумы Obsidian и Discord-сервер (в канале #updates после получения роли developer).

Практическое применение: Станьте частью сообщества!

Этот репозиторий — не просто технический артефакт, это живой пример того, как сообщество может обогащать продукт.

  • Для начинающих разработчиков: Если вы только осваиваете разработку плагинов, изучение структуры community-plugins.json и community-css-theme.json даст вам четкое представление о том, какие метаданные нужны. А понимание процесса загрузки поможет правильно настроить ваш репозиторий и релизы.
  • Для опытных разработчиков: Это ваш прямой путь к широкой аудитории. Следуя простым правилам, вы можете сделать свой плагин доступным для тысяч пользователей.
  • Для любознательных пользователей: Теперь вы знаете, что за "магия" стоит за кнопкой "Установить" в вашем любимом приложении. Это помогает лучше понять, как работает Obsidian и почему он так гибок.

Выводы: Открытость через расширяемость

obsidianmd/obsidian-releases — это блестящий пример того, как даже проприетарное программное обеспечение может создать процветающую и открытую экосистему. Он демонстрирует, что для вовлечения сообщества не всегда нужен полностью открытый исходный код основного продукта. Достаточно предоставить мощные API и четкие, удобные механизмы для публикации расширений.

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

#obsidian #obsidian-md
Проект на GitHub