Статьи живут в виде Markdown-файлов в content/articles/. При запуске npm start или npm run build скрипт scripts/build-content.js сканирует папку, парсит frontmatter и генерирует src/data/articles.generated.ts, который подхватывается приложением.
- Создай файл
content/articles/<slug>.md. Имя файла = slug в URL (/post/<slug>). - Заполни frontmatter и тело:
---
title: Название статьи
date: 2026-05-16
---
Текст в Markdown.
## Подзаголовок
- Изображения положи в
public/images/<slug>/(одна папка на статью), ссылайся как/images/<slug>/file.jpg. SVG-диаграммы можно вынести в отдельный файл и подключить через<inline-svg src="/images/<slug>/diagram.svg" />— build-скрипт инлайнит содержимое в выводе, чтобыcurrentColorадаптировался к теме. - Запусти
npm start— статья появится в ленте, сортировка идёт по дате (новые сверху).
npm run content:build
Перегенерирует src/data/articles.generated.ts из текущих .md.
| Поле | Обязательно | Описание |
|---|---|---|
| title | да* | Заголовок. Если пропустить — будет использован slug. |
| date | да | YYYY-MM-DD. Используется для сортировки и отображения. |
| slug | нет | Переопределяет имя файла. Обычно не нужно. |
talk и work остаются структурированными — правь напрямую в src/data/entries.ts. Markdown-механизм только для статей с длинным телом.
См. MARKDOWN_GUIDE.md — стандартный CommonMark через react-markdown.