Какую задачу решает
Команда, набранная один раз полгода назад, кусок конфига, разбор «почему отвалился Wi-Fi» — всё это расходится по текстовым файлам, закладкам браузера и чату с самим собой. Найти потом получается, только если помнить, где оно лежит.
Заметки вразнобой
ssh.txt,команды.txt,новый сервер (2).txt- связь между заметками держится в голове
- поиск — по одному месту за раз
- картинки и схемы лежат отдельно от текста
Хранилище Obsidian
- одна папка, заметка — файл:
SSH-ключи.md,Новый сервер.md - связь — ссылка
[[SSH-ключи]], и у заметки видно, кто на неё ссылается - поиск по всем заметкам сразу:
tag:#linux path:Linux - картинка стоит прямо в тексте:
![[схема-сети.png]]
Своей базы у Obsidian нет: хранилище — обычная папка на диске, и приложение работает с файлами в ней.
Ссылки, поиск, свойства и плагины добавляются поверх файлов. Закрыли Obsidian — заметки остались, с ними
работают любой редактор, grep и git.
Как устроено хранилище
Хранилище (vault) — папка, которую Obsidian открыл как хранилище. Внутри — заметки, вложенные папки,
картинки и PDF. Ещё там лежит папка .obsidian/ с настройками; в списке файлов Obsidian её не показывает.
notes/
├── .obsidian/ настройки этого хранилища
│ ├── app.json «Файлы и ссылки», редактор
│ ├── appearance.json тема, шрифты
│ ├── core-plugins.json какие встроенные плагины включены
│ ├── community-plugins.json какие сторонние плагины включены
│ ├── plugins/ сторонние плагины, по папке на каждый
│ └── workspace.json открытые вкладки и панели
├── Linux/
│ └── SSH-ключи.md
├── Новый сервер.md
└── схема-сети.png
Настройки у каждого хранилища свои: во втором хранилище плагины, тема и горячие клавиши начинаются с нуля.
Заметка — Markdown с несколькими добавками Obsidian:
---
tags: [linux, ssh]
aliases: [ключи SSH]
status: черновик
---
Ключ кладём на сервер в `~/.ssh/authorized_keys`, клиент настраиваем
в [[SSH config#Host|~/.ssh/config]].
Сервер не пускает — разбор в [[Новый сервер#Если не работает]].
![[схема-сети.png]]
- Свойства — блок YAML между
---в начале файла. Obsidian показывает его таблицей с типами: текст, список, число, флажок, дата.tags,aliasesиcssclasses— списки; однострочныеtag,aliasиcssclassс версии 1.9 не читаются. - Ссылка
[[Заметка]]— по имени файла без.md.#Заголовокведёт к разделу,#^id— к абзацу с меткой^idв конце, после|идёт свой текст ссылки. - Встраивание
![[…]]— та же ссылка с!: картинка, PDF или раздел другой заметки показываются прямо в тексте. - Тег —
#linuxв тексте или в свойствеtags, вложенный —#linux/ssh.
Ссылаться можно и на заметку, которой ещё нет: Obsidian рисует такую ссылку бледнее, а клик по ней создаёт файл с этим именем. Так база и растёт — пишем заметку, ссылаемся на то, что ещё не описано, и дописываем потом.
На панели «Обратные ссылки» у заметки видны все заметки, которые на неё ссылаются. Ниже, в «Упоминаниях без ссылки», — те, где её имя встречается в тексте без ссылки; одним кликом такое упоминание становится ссылкой.
Новые ссылки Obsidian пишет в виде [[…]] (useMarkdownLinks: false) и с самым коротким путём, по которому
файл однозначен (newLinkFormat: "shortest"). Пока SSH-ключи.md в хранилище один, ссылка — [[SSH-ключи]],
без папки.
Из свойств собираются таблицы. Встроенный плагин Bases (с версии 1.9) показывает заметки с фильтром
по свойствам — таблицей, списком или карточками. Сам вид лежит в файле .base, а данные остаются
в свойствах заметок.
Встроенные и сторонние плагины
Почти всё, что умеет Obsidian, сделано плагинами. Встроенные пишет команда Obsidian: обратные ссылки, граф, холст, Bases, шаблоны, ежедневные заметки, восстановление файлов. Включаются они переключателем в настройках, раздел «Встроенные плагины», и чужого кода в них нет.
Сторонние пишут другие авторы, каталог открывается в самом приложении. По умолчанию они выключены: Obsidian работает в безопасном режиме и чужой код не запускает. Выключили безопасный режим — плагин получает те же права, что и сам Obsidian. Справка говорит об этом прямо: ограничить права плагина Obsidian не может, плагин читает файлы на компьютере, ходит в сеть и может поставить другие программы. Каждую версию плагина Obsidian проверяет автоматически на уязвимости и вредоносный код, популярные и помеченные — ещё и вручную.
Что добавляют сторонние плагины:
Tasks
задачиСобирает строки - [ ] со всего хранилища по запросу в блоке tasks: not done, due before tomorrow.
Срок, повтор и приоритет пишутся в самой строке задачи.
Tag Wrangler
тегиПереименовывает и сливает теги во всех заметках сразу — из меню тега на панели тегов.
Codeblock Customizer
кодНомера строк, подсветка выбранных строк и заголовок над блоком кода.
Плагин живёт в .obsidian/plugins/<id>/: main.js — код, manifest.json — имя и версия, data.json —
его настройки. Удалили папку — плагина нет. Заметки при этом не меняются, кроме того, что плагин сам в них
записал: даты задач Tasks остаются текстом в строках.
Где его применяют
База знаний по IT
Команды, куски конфигов, разборы поломок — заметками со ссылками друг на друга. Поиск tag:#docker
собирает всё по теме из любых папок.
Документация рядом с кодом
Папку docs/ репозитория открываем как хранилище, а .obsidian/ добавляем в .gitignore. Если ссылки
обычные Markdown, файлы так же читаются на GitHub.
Журнал работы
Ежедневная заметка — что делали и что сломалось. Задачи из всех таких заметок собирает Tasks.
Черновики текстов
Markdown переносится в README или в сайт на Astro и Hugo без конвертации, если в тексте нет синтаксиса, который понимает только Obsidian.
Заметки для ИИ-агента
Хранилище — папка с текстом, и агент читает и правит её как код. Перед запуском делаем коммит («Чистый git status перед агентом»), а файлы агент переименовывает только вместе со ссылками на них.
Чем ещё решают эту задачу
Аналоги описаны по их документации на октябрь 2026, не запускались.
| Где лежат заметки | Связи | Синхронизация | |
|---|---|---|---|
| Obsidian | папка .md на диске |
[[…]], обратные ссылки, граф |
платная Obsidian Sync или своя: облачная папка, Syncthing, git |
| Logseq | классическая версия — папка .md, новая — база SQLite с копией в Markdown только для чтения |
каждая строка — блок, на него ссылаются отдельно | облачная папка или git; у новой версии — своя синхронизация |
| Joplin | база SQLite в профиле приложения, наружу — экспортом в Markdown | ссылка на заметку по её id: [текст](:/id) |
встроена: Joplin Cloud, Nextcloud, WebDAV, Dropbox, OneDrive, S3, со сквозным шифрованием |
| Notion | облако Notion | ссылки на страницы, базы со связями | облако Notion, общий доступ для команды |
| VS Code | папка .md |
обычные Markdown-ссылки; [[…]] и обратные ссылки — расширением Foam |
своя: git |
| Если… | Берём |
|---|---|
| заметки должны оставаться файлами в папке, нужны ссылки в обе стороны и плагины | Obsidian |
| думаем тезисами, и на каждую строку ссылаемся отдельно | Logseq |
| нужна синхронизация с шифрованием на свой Nextcloud или WebDAV без плагинов | Joplin |
| заметки ведёт команда, нужны общие базы и права доступа | Notion |
| заметки — часть репозитория, а работаем и так в VS Code | VS Code |
Что получаем и чем платим
Получаем
- Файлы остаются файлами. Заметку открывает любой редактор, находит
grep, хранит git («Git»). Уйти с Obsidian — значит открыть ту же папку другим редактором; пропадёт то, что рисуют плагины, и ссылки на блоки#^id. - Связи в обе стороны. Ссылку ставим в одной заметке, а видна она в обеих: у второй — на панели обратных ссылок.
- Работает без сети. Заметки, поиск и индекс — на диске. Сеть нужна для обновлений, каталога плагинов и Sync.
- Бесплатен для любых целей, и для работы тоже: лицензия не требует покупки. Платные — сервисы Sync и Publish (сайт из заметок).
- Расширяется. Чего нет во встроенных плагинах, добавляют сторонние; темы и свои CSS-сниппеты меняют вид.
Платим
- Часть синтаксиса понимает только Obsidian.
[[…]],![[…]]и ссылки на блоки GitHub и другие редакторы показывают текстом. - Сторонний плагин — код с доступом ко всему компьютеру. Права плагина Obsidian не ограничивает, поэтому смотрим, кто автор и обновляется ли плагин.
- Настройки по умолчанию копят беспорядок. Новые заметки и вставленные картинки падают в корень хранилища
(
newFileLocation: "root",attachmentFolderPath: "/"), а при переименовании Obsidian каждый раз спрашивает, обновлять ли ссылки (alwaysUpdateLinks: false). - Переименование мимо Obsidian ломает ссылки. Проводник, скрипт или ИИ-агент меняют имя файла, Obsidian видит удаление и новый файл, и ссылки остаются со старым именем.
- Синхронизацию собираем сами. Бесплатной встроенной нет: платная Obsidian Sync или своя — облачная папка,
Syncthing, git. Справка не советует запускать Obsidian Sync вместе с другой синхронизацией на одном
хранилище. Git сам ничего не отправляет:
pullиpushзапускаем мы или плагин. - Код приложения закрыт. Открыты форматы — Markdown у заметок и JSON Canvas у холстов, — а само приложение нет.
Что меняем в настройках сразу
Все три — в настройках, раздел «Файлы и ссылки»:
| Настройка | По умолчанию | Ставим |
|---|---|---|
| Всегда обновлять внутренние ссылки | выключено: при каждом переименовании — вопрос | включено: ссылки правятся без вопроса |
| Место для новых заметок по умолчанию | корень хранилища | «В той же папке, где расположен файл» |
| Место для вложенных файлов по умолчанию | корень хранилища | «В подпапке в текущей папке» или папка attachments |
Переименовываем и переносим файлы только в Obsidian: имя файла — это заголовок над текстом заметки, его и правим, а переносим перетаскиванием в списке файлов.
Хранилище кладём в git с первого дня, тогда перед большой уборкой и перед работой ИИ-агента есть точка
возврата («Git с нуля»). В .gitignore — .obsidian/workspace.json: он меняется при каждом
переключении вкладки.
Если не работает
Переименовали заметку в Проводнике, и ссылки на неё ведут на новую пустую заметку
- Причина
- Об этом переименовании Obsidian не знает. Снаружи он видит удаление старого файла и появление нового, а ссылки со старым именем остаются висеть. Клик по такой ссылке создаёт пустой файл с этим именем.
- Делаем
- Возвращаем файлу старое имя и переименовываем внутри Obsidian. Если файлы переносят скрипт или ИИ-агент, ссылки им тоже приходится править самим.
Переименовали в Obsidian, а ссылки в других заметках остались старыми
- Причина
- «Всегда обновлять внутренние ссылки» по умолчанию выключено (
alwaysUpdateLinks: false). Obsidian спрашивает, обновлять ли ссылки, а «Не обновлять» или закрытое окно оставляют их как были. - Делаем
- В настройках, раздел «Файлы и ссылки», включаем «Всегда обновлять внутренние ссылки». Уже висящие ссылки находим поиском по старому имени.
В корне хранилища копятся файлы Pasted image 20261024103512.png
- Причина
- Вставленная картинка сохраняется туда, куда указывает «Место для вложенных файлов по умолчанию». По умолчанию это корень хранилища (
attachmentFolderPath: "/"). - Делаем
- Ставим «В подпапке в текущей папке» или отдельную папку
attachments. Накопившиеся картинки переносим перетаскиванием в списке файлов Obsidian — тогда ссылки на них обновятся.
На GitHub ссылки [[…]] показываются обычным текстом
- Причина
- Wiki-ссылки — синтаксис Obsidian, в обычном Markdown их нет. Ссылки на блоки
#^idза пределами Obsidian не работают ни в каком виде. - Делаем
- Для заметок, которые читают на GitHub, выключаем «Использовать [[Wiki-ссылки]]»: новые ссылки Obsidian запишет в виде
[текст](Заметка.md).
Каталог сторонних плагинов не открывается, плагин не ставится
- Причина
- Включён безопасный режим. В нём Obsidian запускается по умолчанию и чужой код не выполняет.
- Делаем
- В настройках, раздел «Сторонние плагины», выключаем безопасный режим. Плагин получит доступ к файлам и сети, поэтому ставим только то, что решает конкретную задачу.
Затёрли кусок заметки или удалили её целиком
- Причина
- Obsidian сохраняет каждую правку сам, кнопки «не сохранять» у него нет.
- Делаем
- Включённый встроенный плагин «Восстановление файлов» делает снимки не чаще раза в 5 минут и хранит их 7 дней вне хранилища; открываем их из палитры команд
Ctrl+P. Удалённая заметка уходит в корзину системы (trashOption: "system").