Как я 15 лет делал себе персональную Wiki для программиста

Существует два типа инструментов

Программисты предопочтивают второе, потому что пользуются vim, emacs, кучей разных шорткатов.

Пример такой софота, который работает через Markup Languages и предназначен для wiki: Wikipad.

Григорий когда использовал Wikidpad

В итоге Григорий пришел к собственному синтаксису, похожему на markdown. Синтаксис параграфов работает как блоки в pyton. Отступ это вложенный параграф или вложенный список. Максимальная вложенность – 6

Еще разработчики привыкли к дереву файлов(outliner)

Однако, записи программиста это не дерево, а граф. Outliner не умеет это отображать, а поиск по контенту работает лучше чем поиск по outliner.

Плагин

Сейчас Xi существует в виде плагина для раскраски синтаксиса, позволяет кликать на слова. Каждая статья – 1 файл. Outline`а в привычном виде нет, он переехал в начало статьи, сделан в виде ссылок на другие статьи, связанные с темой статьи.

Сейчас плагин работает в VSCode, существует отдельная цветовая схема, в которой много контрастных цветов для более гибкого обозначения типов контента. Отдельные цвета для терминов, уровня вложенности, кода, списков, примеров и т.д. За основу взята темная тема, синтаксис разметки тоже сделан темным, чтобы сливаться с фоном редактора и не мешать во время чтения заметки.

Фичи

Для таблиц и картинок используются Google Drive и Google Sheets.

Выводы