Перейти к содержимому
Борис Новичков
РезюмеGitHub ↗
ENRU
Все работы

Netwik

Общая сеть заметок внутри Obsidian, живущая в тысячах хранилищ

Плагин для Obsidian, добавляющий к приватному хранилищу публичный слой, который редактируют совместно. Любую заметку можно опубликовать в общей сети, связать по URL, найти через автодополнение прямо в редакторе и отредактировать — а изменения разойдутся по хранилищам всех участников.

Выпущен
Роль
Автор — плагин и бэкенд
Период
март 2021 — сент. 2021
Obsidian — палитра команд
Create note
Опубликовать новую заметку в общей сети.
Update note
Подтянуть последние изменения из облака для текущей заметки.
Upload current note
Перенести существующую локальную заметку в общий слой.
Sync base
Свести локальную копию с облаком.
Copy obsidian url
Сделать ссылку obsidian://netwik?id=… — её откроет любой, у кого есть плагин.
Delete remote note
Удалить заметку из сети целиком, а не только из этого хранилища.

Настоящий набор команд плагина, как он описан в README.

Идея

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

Наберите символ-триггер посреди предложения — и получите автодополнение по общей сети. Выберите результат: вставится обычная внутренняя ссылка, а заметка скачается. Наберите заголовок, которого ещё нет, и Shift+Enter его создаст. Отправьте кому-нибудь ссылку obsidian://netwik?id=… — она откроется в его хранилище, предварительно скачав заметку, если он её никогда не видел.

Ограничения, которые формировали дизайн

Хранилище должно пережить плагин. Общие заметки пишутся в папку w/ как обычный markdown. Удалите плагин — останутся читаемые файлы. Удалите локальный файл — с сетью ничего не случится: локальная копия нужна для навигации, а не как источник истины.

Имена — для людей, идентификаторы — для машин. Имя файла несёт идентификатор заметки, чтобы ссылки переживали переименования, но в режиме предпросмотра показан только заголовок, — поэтому хранилище не выглядит как дамп базы данных.

Перемещение файла — это акт публикации. Перетащите любую заметку в w/, и она будет разобрана и загружена, а затем переименована в каноническую форму. Жест, которым люди и так раскладывают файлы, стал жестом «поделиться».

Итог

Netwik уехал в официальный каталог плагинов сообщества Obsidian под именем Union Vault и набрал 4241 зафиксированную установку. Это моя работа, которая поработала в наибольшем числе чужих рук, и урок, который остался, был про сценарии отказа: синхронизирующему плагину доверяют только тогда, когда любой его сбой оставляет пользователя с простыми файлами, которые всё ещё открываются.

как открывается общая ссылка
# a link to a note this vault has never seen$ open "obsidian://netwik?id=6f2c…"plugin intercepts the URL schemefetches the note from the shared storewrites it into w/ as ordinary markdownnote opens in the editor, fully linkable

Что происходит за одним кликом по ссылке Netwik.