Плагин для Obsidian · 0.1.0

Ссылка, которую видно

Голый адрес в заметке через месяц уже ничего не говорит. Link Card показывает вместо него карточку с картинкой, заголовком и описанием, и сразу понятно, куда ведёт ссылка. Даже если это рабочая вики, куда пускают только по токену.

Установить Как сделать карточку

Obsidian 1.11.4+ Чтение и Live Preview Без сервисов превью

Релиз 2.4

Перед выкаткой сверяемся с регламентом:

Сайт закрыт, карточка загружена по профилю «Вики» с токеном.

Как сделать карточку

Возьмите любую ссылку в заметке и допишите в конец #card:. Всё, это уже карточка. Если хочется настроить вид, например взять другую картинку или поставить её сверху, параметры пишутся после двоеточия.

Заметка от этого не ломается. Кто откроет её без плагина, увидит обычную ссылку, и она откроется как раньше: часть адреса после # браузер на сайт не отправляет. Если у ссылки уже был свой якорь, он остаётся: #intro&card:….

<!-- карточка с настройками по умолчанию -->
[](https://wiki.corp.local/pages/12345#card:)

<!-- свой заголовок, первая картинка, сверху -->
[Регламент релизов](https://wiki.corp.local/
  pages/12345#card:image=first&layout=vertical)

<!-- голый адрес со своим якорем -->
https://example.com/post#intro&card:image=2

Параметр	Значения
`image`	какую картинку взять: обложку страницы `og`, первую `first` или по номеру `2`, свою по адресу или `[[вложение]]`, иконку сайта `favicon` или никакую `none`. Можно перечислить через запятую, возьмётся первая найденная
`layout`	картинка слева `horizontal`, сверху `vertical` или маленькая карточка в строку `compact`
`title`	свой заголовок. Без него берётся текст ссылки, а если его нет, заголовок страницы
`description`	описание со страницы `auto`, без описания `none` или свой текст
`profile`	каким профилем входить на сайт. Обычно не нужен: профиль подбирается по адресу

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

Рабочая вики за логином

Обычные сервисы превью тут бессильны: страница вашей вики, задача в Jira или проект в GitLab им просто не откроются. Link Card ходит на такие сайты сам, от вашего имени.

Для этого один раз заводится профиль: как он называется, к каким адресам относится (например, все https://*.corp.local) и как входить. Подойдёт токен доступа, логин с паролем, cookie из браузера или свой заголовок запроса. Нажмите «Проверить», и плагин сразу покажет, пустил ли сайт и что он нашёл на странице.

Токен хранится в хранилище секретов Obsidian на этом устройстве. В файлы хранилища и в синхронизацию он не попадает, а отправляется только на адреса своего профиля. Если сайт перенаправит запрос куда-то ещё, токен туда не уйдёт.

Без посредников

Заголовок, описание и картинку плагин берёт прямо со страницы, на которую ведёт ссылка. Ваши адреса не уходят в сторонние сервисы превью, и никакой статистики плагин не собирает.

Заметки остаются чистыми

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

Сайт лёг — карточка на месте

Карточка появляется сразу, а свежая версия подтягивается в фоне. Если сайт не отвечает или вы без сети, остаётся последняя удачная карточка с пометкой «устарело» и объяснением, что случилось.

Карточка закрытой страницы: картинка слева, заголовок «Закрытая страница», описание «Видна только с токеном» и кнопки при наведении — Карточка страницы, которая открывается только с токеном. Наведите на неё, чтобы обновить вручную.

Настройки профиля: адреса, авторизация Bearer-токен, секрет и кнопка «Проверить» с результатом HTTP 200 — Профиль для вики: адреса, токен и ответ сайта после «Проверить».

В следующей версии · 0.2.0

Сайты, которые пускают по сертификату. Некоторые внутренние сервисы проверяют не пароль, а сертификат на компьютере (mTLS). Его можно будет указать в профиле, файлом PEM или PFX. Только на компьютере.
Выбор при вставке адреса. Вставили ссылку, и плагин спросит, чем её сделать: ссылкой с заголовком страницы, карточкой или оставить как есть. Выбор запомнится для сайта.
Вход через окно для сайтов с единым входом: откроется отдельное окно, вы залогинитесь как обычно, и плагин будет ходить с этой сессией.
Выбор картинки из галереи всех картинок страницы, а для сложных сайтов — по CSS-селектору image=selector:.
Заморозка карточки. Карточка сохранится прямо в заметке блоком ```card, а картинка во вложения. Такая карточка видна всегда, даже без сети и даже если сайт однажды закроют.

Установка

В каталоге Obsidian плагина пока нет, поэтому ставится он вручную. Это займёт минуту.

Скачать Link Card 0.1.0

zip · 20 КБObsidian 1.11.4+Компьютер и телефон

Или по файлам: main.js · manifest.json · styles.css

SHA-256 архива: 22217b3b480fca53463ac0bea47950a568eebfae471b7363d2a0891a21cbdfdf

Скачайте архив кнопкой выше.
Распакуйте его в папку .obsidian/plugins/ внутри хранилища: появится папка link-card с файлами плагина. Папку .obsidian не видно в Obsidian, откройте хранилище в проводнике.
Включите плагин: «Настройки → Сторонние плагины», найдите Link Card и включите переключатель.
Попробуйте: допишите #card: к любой ссылке в заметке. Карточка появится в Live Preview и в режиме чтения.

Чтобы карточки работали с рабочей вики или трекером, загляните в «Настройки → Link Card → Профили»: добавьте адреса сайта, токен и нажмите «Проверить».

Вопросы

Что увидит человек без плагина?

Обычную ссылку, которая открывается как раньше. Хвост #card:… останется в адресе, но браузер его на сайт не отправляет, так что сайт ничего не заметит.

Куда плагин ходит в сеть?

Только туда, куда ведут ваши ссылки: на саму страницу, за её картинками и иконкой. Ещё на тестовый адрес профиля, когда вы нажимаете «Проверить». Сторонних сервисов, телеметрии и аналитики нет.

Синхронизируется ли токен на другие устройства?

Нет, и это сделано нарочно. Сам профиль переедет вместе с настройками, а токен живёт только на этом устройстве, в хранилище секретов Obsidian. На другом устройстве его нужно ввести ещё раз.

Работает на телефоне?

С открытыми сайтами да. Профили с токеном на телефоне по умолчанию выключены: там плагин не может проследить, куда сайт перенаправит запрос, и не гарантирует, что токен не уйдёт чужим. Если вас это устраивает, включите настройку «Секреты на мобильном».

Попадут ли карточки в git или синхронизацию?

Нет. Карточки и картинки хранятся во внутренней базе приложения на устройстве (IndexedDB), а в заметке остаётся только ссылка. Поэтому git-история и синхронизация не разбухают от картинок.

Почему запросы с токеном идут не через Obsidian?

Встроенная в Obsidian функция запросов requestUrl при перенаправлении на другой сайт отправляет туда и заголовок с токеном. Поэтому на компьютере запросы с секретом идут через сетевой модуль Node, и перенаправления плагин разбирает сам. Параметр profile= в ссылке тоже не расширяет список адресов профиля.