Как устроен этот блог

27 июня 2026 г. · Пётр Евсиков

TL;DR

Статья — это один .md файл в папке articles/
Frontmatter задаёт заголовок, теги, дату и TL;DR
Поддерживаются код с подсветкой, таблицы, цитаты и оглавление

Этот пост одновременно демонстрация оформления и инструкция. Если ты его видишь в блоге — значит, движок собрал markdown в страницу.

Как добавить статью

Один пост — это один markdown-файл в папке articles/. Никакой админки и базы данных.

Создай файл articles/my-post.md.
В начале добавь frontmatter (метаданные между ---).
Запусти npm run dev — пост сразу появится в ленте.
Для публикации: npm run build собирает статические страницы, sitemap и RSS, затем деплой на GitHub Pages.

Минимальный frontmatter выглядит так:

---
title: "Заголовок поста"
description: "Короткое описание для ленты и SEO."
tags: ["rag", "agents"]
slug: "my-post"
lang: "ru"
datePublished: "2026-06-27"
author: "Пётр Евсиков"
tldr: ["Тезис один", "Тезис два"]
---

После frontmatter — обычный markdown. Имя файла и slug дают адрес: /articles/my-post/.

Что умеет оформление

Текст и ссылки

Работает полужирный, курсив и инлайн-код. Ссылки выглядят так: главная блога или внешний сайт. Длинные абзацы держат комфортную ширину строки для чтения.

Блоки кода с подсветкой

Код подсвечивается автоматически по указанному языку:

from pydantic import BaseModel

class QA(BaseModel):
    question: str
    answer: str

def extract(text: str) -> list[QA]:
    # вызов локальной модели через Ollama
    return run_llm(text, schema=QA)

И команды в шелле:

ollama run qwen3:30b-a3b "Сделай выжимку из этого транскрипта"

Списки

Маркированный список:

первый пункт
второй пункт с кодом
третий пункт

Нумерованный — выше, в разделе про добавление статьи.

Цитата

Дисциплина бьёт талант: один артефакт и один пост в день. Через 90 дней это уже система, а не намерение.

Таблица

Этап	Инструмент	Результат
Инференс	Ollama / MLX	локальный ответ модели
Retrieval	Chroma + BM25	релевантные чанки
Оценка	Ragas	faithfulness, recall@k

Изображения

Картинки вставляются стандартным синтаксисом markdown:

![Подпись к картинке](/путь/к/картинке.png)

Оглавление и TL;DR

Заголовки уровня ## и ### автоматически собираются в оглавление слева от текста, а блок TL;DR берётся из frontmatter. Время чтения считается по объёму автоматически.

Дальше

Это служебный демо-пост — его можно удалить, когда появятся настоящие записи. Первая боевая статья — день 1 учебного плана: «LLM как компонент». С неё и начнём.