basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Obsidian: что это и как он хранит заметки

    Obsidian — редактор заметок поверх обычной папки: заметка — файл .md, связь между заметками — ссылка [[…]]. Сверху приложение добавляет обратные ссылки, поиск по всему хранилищу, свойства и плагины. Файлы при этом остаются читаемыми без Obsidian: их открывает любой редактор, находит grep и хранит git.

    Какую задачу решает

    Команда, набранная один раз полгода назад, кусок конфига, разбор «почему отвалился 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").