Ilya Vorontsov / Илья Воронцов

Настройка Obsidian

время чтения ~5 мин.

Список плагинов

  • Front Matter Title
  • OmniSearch

Показывать в FileExplorer заголовки вместо названий файлов

Установить плагин Front Matter Title и настроить его (включить, как минимум, в Explorer).

Горячие клавиши OmniSearch

Заменил в настройках Ctrl+F/Ctrl+Shift+F с дефолтных на OminSearch-ные

Нормальный формат даты

Формат в properties

Чтобы поменять формат даты в properties, нужно запускать приложение с другой локалью, например, en_GB. Поменять язык в приложении не помогает.

env LANG=en_GB.utf8 LC_ALL=en_GB.utf8 LANGUAGE=en_GB /opt/bin/Obsidian-1.8.10.AppImage --lang=en_GB

Это же можно прописать в .desktop-файле.
Рекомендация взята с форума Obsidian (1)
См.также заметку про .desktop и AppImage.

Формат в DataView

Не знаю пока, где это используется, но выяснил, что формат дат нестандартный и описан в документации Luxon.

Публикация в форме сайта

Сестра советует Quartz (он же на гитхабе)
Есть ещё такая заметка про то, как с его помощью публиковать
защита паролем — (1) и (2); также есть про private pages
подумать про автоматический деплой с гитхаба через хуки

Концепция Digital Garden.

Web Clipper

Скачал этот. Для интеграции с Obsidian настроил vault в плагине и установил Advanced URI.
История поисков: Вот тут нашёл плагин исходно MarkDownload. Оказалось, что в хроме он больше не поддерживается. В Issue #372 гитхаб-репозитория нашёл ссылку на форк.

  • Alt+Shift+M: Open MarkSnip popup
  • Alt+Shift+D: Download current tab as Markdown
  • Alt+Shift+C: Copy current tab as Markdown
  • Alt+Shift+L: Copy current tab URL as Markdown link

Но в обсидиан почему-то ничего не скачивается.

Синхронизация с мобильным через GitSync

Вроде как нужно на телефоне установить Termux, через него установить git, открыть GitSync авторизоваться на гитхабе, сделать синхронизацию с ним в папку obsidian vault’а. Дальше настроить автосинк при открытии/закрытии обсидиана.

Иногда приходится синк/пулл/пуш делать вручную. Наверное неплохая идея завести отдельную ветку под мобилку и пушить туда.

Иногда возникают проблемы: GitSync говорит, что не может сделать pull, т.к. есть незакоммиченные изменения.
Я попытался выяснить проблему прямо через git, но что-то не удалось.
Выяснил, что в Termux надо искать папку /storage/emulated/0/Documents/obsidian/. Зашёл туда и попытался сделать git status, но git просто не нашёл репозитория. Причина не вполне понятна. Чатгпт предложил сделать папку в домашней папке Termux, и оттуда попытать счастья, потому что там, мол, git должен работать лучше (а между домашней папкой и папкой обсидиана делать rsync), но мне это кажется извращением.

Не создавайте в репозитории файлы со спец.символами в имени. Например, знак вопроса в имени файла, похоже, ломает GitSync.

Удаление несвязанных/бесхозных (orphaned) прикрепленных файлов

Установил плагин Find orphaned files and broken links.
Настроил папки, которые не хочу синхронизовывать.
Установил настройку Files and links → New link format в значение Absolute path in vault, что хочу генерировать полные ссылки.
Вызвал команду (Ctrl+P) Find orphaned files.

Затем прошёлся в цикле и удалил файлы:

grep -oPe '(?<=\[\[)files/.+(?=\]\])'  "orphaned files output.md" | (
  while IFS= read -r line; do  # игнорировать пробелы
    echo "$line"
    ## раскомментировать, когда убедитесь в том, что выбраны нужные файлы
    # rm "$line"
  done)

Как вести FrontMatter-тэги

Вместо url принято использовать source.

Формат дат указывается так: 2025-04-03T23:45:12+03:00

Публикация digital garden при помощи quartz

Взял Quartz 4.

Мне было недостаточно просто указать ./content как симлинк на репозиторий. Оказалось, что при этом файлы в обсидиан-репозитории не считываются как находящиеся под контролем git, и потому у них сбивается дата публикации (и заодно я получаю кучу warning-ов). Решение — явно указывать путь к репозиторию через опцию -d:
npx quartz build -d ~/brain/

В папке ./public появляется содержимое статического сайта. Можно запустить как статику.

Папки, которые не публикую, добавил в секцию ignorePatterns в quartz.config.ts. Работает поганенько, но это единственный способ не публиковать файлы из папок. Флажки publish/draft работают только в markdown файлах, а на всевозможные приложения это не распространяется.

Добавил плагин HardLineBreaks и в CrawlLinks отредактировал опцию openLinksInNewTab.

В ObsidianFlavoredMarkdown поставил опцию mermaid: false для ускорения (см. Speed up Obsidian Quartz page loads - vxlabs).

Для веб-аналитики поставил Community-версию Plausible, но надо учитывать, что она требует хотя бы 2Gb RAM.

Quartz не публикует frontmatter теги source итп. Чтобы это исправить, добавил собственный компонент FrontmatterTable и подключил его в quartz.layout.tsx (мне пришлось переименовать расширение .ts в .tsx, чтобы сделать во frontmatter рендеринг ссылок, хотя лучше бы это перенести в компонент). Но список рендерящихся тегов сейчас нужно прописывать вручную (возможно, в будущем будет изменено).

В телеграм-постах добавил ссылки prev/next, чтобы связать посты. Это отображается во frontmatter (но только в quartz это рендерится как ссылки, но не в obsidian, увы). Это позволило мне избежать ссылок внутри текста, которые делали весь телеграм-канал единой компонентой графа.

Добавил опцию для игнорирования orphan вершин в глобальный граф.
todo Надо бы предложить pull request этого в основной репозиторий.

Добавил комментарии на giscus

Думаю над тем, как:

  • создать стабильную схему URL (возможно, нужны UUID), помимо вручную проставленных permalinks (например, на копии тг-постов)
  • закрыть часть страниц паролем
  • сделать работающий transclusion (см. диалог с chatgpt) страниц. upd: Оно работает само по себе, но нужно указывать правильный путь к заметке (вероятно, согласованный с правилами разрешения путей в обсидиане, но не уверен)

И надо продумать, как правильно держать репозиторий quartz и obsidian vault, чтобы они лежали рядом, но не мешали друг другу.

Работа в quartz

Поиск — ctrl + K, поиск по тэгам — ctrl + shift + K.

ToDo

  • Завести темплейты для daily notes и телеграм-постов
  • Сделать возможность создавать заметки одним кликом, не задавая имя (в т.ч. на телефоне), как в zettelkasten
  • Разобраться с горячими клавишами
  • Настроить плагин MarkSnip, чтобы можно было одним кликом сохранять веб-странички в обсидиан. Сейчас он скачивает маркдаун и файлы картинок, но эти файлы названы с префиксом папки. И сохраняются в downloads, а не обсидиан. Я пытался настроить хэндлеры (связанные с xdg-open, mime-type, custom protocols), но пока не вышло. Браузер Chrome, например, понимает ссылки obsidian:// как ссылки на странице, но в адресной строке воспринимает их как поисковый запрос, а не протокол.
  • Понять, может ли MarkSnip нормально выкачивать видео и картинки из background-url (в постах Татьяны Мисюриной было много таких косяков) + не терять подписи к картинкам и целые абзацы рядом с заголовками
  • Разобраться с плагином DataView
  • скачать в обсидиан посты habr, fb, vk, lj, diary, ig, песни с music.lib.ru
  • выгрузить комменты из тг-постов и соцсетей
  • разобраться с многосложными тегами (вставить дефисы)
  • разобраться с counter, чтобы вести нумерацию записей

Вид графа