Разработка15 октября 2026 г.5 мин чтения#ux#markdown#design#typography#katex

Анатомия современного инженерного текста на y7.hk

Ультимативный стресс-тест движка чтения y7: коллауты, diff-блоки, KaTeX формулы, видеокружок, галерея с подписями figure, спойлеры details, таблицы, сноски и переключатель шрифтов.

Анатомия современного инженерного текста на y7.hk

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


1. Врезки и примечания (Callouts)

Врезки вписаны в общий монохромный стиль сайта — чистые инсет-блоки без светофора из разноцветных рамок:

Примечание

Использует мягкий полупрозрачный фон –muted и системную рамку. Идеально сочетается с типографикой и не отвлекает от чтения статьи.

Совет разработчику

Кнопка Aa Serif в правом верхнем углу переключает шрифт на антикву Georgia для лонгридов. Настройка автоматически сохраняется в браузере.

2. Изображения и медиа

Архитектура дизайн-системы y7
Рис. 1. Генерация OpenGraph и визуальная система y7.hk (Geist Sans + OKLCH)

Сравнение двух вариантов (Grid медиа)

Сетка из двух изображений для сравнения интерфейсов «До» и «После»:

Вариант A
Вариант А: Старый плоский стиль
Вариант B
Вариант B: Обновленный Linear-стиль

Живой видео-аватар автора

Круговой видео-компонент, интегрированный в интерфейс карточки:

Portrait of Yakushev Hermann
Yakushev Hermann
Product Engineer · Southeast Asia

/me.mp4


3. Код, Diff-патчи и Терминал

Diff-патч рефакторинга

Строки со вставками подсвечиваются мягким изумрудным цветом, удаленные — приглушенным красным:

  export async function handleRequest(req: Request): Promise<Response> {
-   const legacyToken = req.headers.get("x-legacy-token");
-   if (!legacyToken) return new Response("Unauthorized", { status: 401 });
+   const authSession = await verifyAgentSession(req);
+   if (!authSession.valid) {
+     return Response.json({ error: "Session expired" }, { status: 403 });
+   }

    return await processWorkflow({
-     mode: "sync",
+     mode: "streaming-duplex",
      timeout: 30000,
    });
  }

Команда терминала (Bash)

Символ $ не копируется в буфер обмена благодаря селектору user-select: none:

git clone https://github.com/yakushev/Y.git && cd Y
npm install
npm run build

4. Математика и формулы KaTeX

Выключная формула (Display Math)

Сложные формулы рендерятся с поддержкой горизонтальной прокрутки на мобильных устройствах:

\mathcal{L}_{\text{total}} = \alpha \cdot \mathbb{E}_{x \sim p_{\text{data}}}\left[\log D(x)\right] + \beta \cdot \sum_{i=1}^{N} \left\| \nabla_x f(x_i) \right\|_2^2

Формула внимания Transformer Attention1:

\text{Attention}(Q, K, V) = \text{softmax}\left(\frac{QK^T}{\sqrt{d_k}}\right)V

Инлайн-формулы

Математические символы и уравнения прямо внутри текста: e^{i\pi} + 1 = 0, матричное умножение A \times B \in \mathbb{R}^{m \times p} и норма градиента \|\nabla \theta\| \le \epsilon.


5. Таблицы со скролл-поддержкой

Таблицы автоматически оборачиваются в адаптивный скролл-контейнер и сохраняют читаемость на смартфонах:

Метод / Технология Скорость отклика Сложность Статус в 2026
Astro 7 SSG < 20ms (Edge CDN) Низкая В продакшене
React 19 Islands Частичная гидратация Средняя Активно
OKLCH Tokens Мгновенно (CSS) Минимальная Стандарт
Web Audio API Нулевая задержка Низкая Включено

6. Сворачиваемые спойлеры (<details>)

Интерактивные аккордеоны для скрытия логов или опциональных фрагментов:

Показать полный JSON-пейлоад ответа LLM

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

{
  "id": "chatcmpl-98a72b",
  "model": "deepseek-r1",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Паттерн успешно валидирован."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 128,
    "completion_tokens": 42
  }
}
Системные требования и окружение
  • Node.js ≥ 22.0.0 или Bun ≥ 1.1
  • Поддержка современных браузеров с OKLCH цветами
  • Память сборки: ~250 МБ RAM

7. Чеклисты и горячие клавиши

Список задач в формате Markdown:

  • Настроена поддержка цветных коллаутов
  • Реализована подсветка diff-кода
  • Внедрены математические формулы KaTeX
  • Добавлен переключатель Serif / Sans
  • Оформлены подписи <figcaption> к медиафайлам
  • Запланировано добавление интерактивных 3D canvas сцен

Горячие клавиши для управления:

  • Нажмите ⌘ + K для глобального поиска.
  • Нажмите ~ для вызова консоли.
  • Нажмите Esc для закрытия любого всплывающего окна.

8. Цитаты с авторством

Дизайн — это не то, как предмет выглядит и ощущается. Дизайн — это то, как он работает. Стив Джобс


9. Академические сноски

Текст со ссылкой на первоисточник о трансформерах2. При клике на номер сноски вас мгновенно перенесет в нижнюю панель сносок, а нажав на значок стрелки ↩, вы вернетесь точно к месту чтения.

Footnotes

  1. Внимание — ключевой компонент архитектур современных больших языковых моделей (LLM). ↩

  2. Vaswani et al., «Attention Is All You Need», NIPS 2017. ↩

Portrait of Yakushev Hermann
Якушев Герман
Предприниматель и визионер · Архитектор AI-агентов · Нетворкинг
Обо мне

Ещё из блога

Жизнь между часовыми поясами

Чему учат 67 стран и четыре домашние базы — про глубокую работу, джетлаг и продукты, которые никто не просил строить.

18 июл. 2026 г. · 6 мин чтения

Почему я строю персональный сайт как продукт

Персональный сайт — это не визитка, а продукт: с роадмапом, метриками и пользователями. Рассказываю, как я проектирую y7.hk.

5 июл. 2026 г. · 7 мин чтения