BLBy Elibekyan
Menu

BL / Blog

Atlas Archive

Essays, notes, technical writing, travel, and project logs.

BL / Технологии

MDX-блог как легкий архив

Как соединить статические статьи, поиск, RSS и живые компоненты так, чтобы блог оставался быстрым и понятным.

§Почему MDX подходит

MDX хорош для личного блога не потому, что позволяет вставлять любой интерфейс внутрь текста. Это скорее побочный бонус. Главная сила в другом: статья остается файлом, который можно читать, версионировать и переносить, но при необходимости она получает компонент там, где обычного Markdown уже мало.

Такой формат особенно хорошо подходит для проектных заметок. В одном материале может быть обычный текст, короткая справка, список решений, маленький интерактивный блок или таблица с выводами. При этом источник не превращается в тяжелую CMS.

§Индекс важнее бесконечной ленты

Для этого блога главная страница работает как редакционный индекс. Последняя статья видна сразу, категории показывают карту тем, поиск остается рядом с архивом. Лента не пытается быть социальной сетью и не заставляет читать по хронологии.

§Поиск должен быть локальным

Если все статьи уже доступны на сборке, нет причины делать внешний поисковый сервис на старте. Достаточно подготовить небольшой search index из заголовка, описания, категории, тегов и очищенного текста. Клиентский компонент фильтрует его мгновенно и не трогает сервер.

§RSS остается уважительным жестом

RSS не модная фича, а знак, что текст можно читать в своем темпе. Для персонального сайта это почти идеальный контракт: новые материалы появляются в feed, но читатель сам выбирает инструмент и ритм.

§Что остается на сервере

Список статей, фронтматтер, оглавление и related-подборка считаются на сервере. На клиент уходят только поиск, активный пункт TOC и reading progress. Так блог остается быстрым, а JavaScript отвечает только за то, что действительно меняется в браузере.