Учебник MDX

Введение
- Что такое MDX
- История создания и эволюция
- Основные возможности и преимущества
- Сравнение с Markdown и JSX
- Когда использовать MDX
- Экосистема и инструменты
Установка и настройка окружения
- Требования к системе
- Установка через npm и yarn
- Интеграция с различными сборщиками
- Настройка TypeScript
- Проверка работоспособности
Синтаксис MDX
- Базовый Markdown синтаксис
- Встраивание JSX компонентов
- Импорт и экспорт в MDX
- Использование выражений JavaScript
- Работа с переменными и константами
- Комментарии в MDX документах
- Экранирование специальных символов
- Ограничения синтаксиса
Компоненты в MDX
- Встраивание React компонентов
- Передача props компонентам
- Деструктуризация props
- Children и вложенные элементы
- Замена стандартных Markdown элементов
- Динамические компоненты
- Компоненты высшего порядка
- Обработка ошибок в компонентах
Провайдеры и контекст
- MDXProvider и его назначение
- Глобальная замена компонентов
- Вложенные провайдеры
- Передача данных через контекст
- Кастомизация рендеринга
- Приоритеты и переопределение компонентов
Работа с метаданными
- Frontmatter в MDX
- Экспорт метаданных
- Типизация метаданных
- Использование метаданных в компонентах
- Валидация метаданных
- Динамические метаданные
Интеграция с фреймворками
- Next.js и MDX
- Gatsby и MDX
- Remix и MDX
- Vite и MDX
- Astro и MDX
- Create React App
- Конфигурация webpack
- Конфигурация esbuild
- Конфигурация Rollup
Плагины и расширения
- Архитектура плагинов MDX
- Remark плагины
- Rehype плагины
- Создание собственных плагинов
- Популярные плагины для MDX
- Порядок применения плагинов
- Конфигурация и параметры плагинов
- Отладка плагинов
Обработка Markdown элементов
- Заголовки и якоря
- Списки и вложенность
- Ссылки и изображения
- Таблицы
- Блоки кода и подсветка синтаксиса
- Цитаты
- Горизонтальные линии
- HTML в MDX
Работа с кодом
- Inline код
- Блоки кода
- Подсветка синтаксиса
- Нумерация строк
- Выделение строк
- Названия файлов
- Live код и песочницы
- Копирование кода
Стилизация MDX контента
- CSS и MDX
- CSS Modules
- Styled Components
- Emotion
- Tailwind CSS
- Глобальные стили
- Изолированные стили
- Темизация
Динамический контент
- Условный рендеринг
- Циклы и итерация
- Асинхронные данные
- Fetch и загрузка данных
- State management в MDX
- Интерактивные элементы
- Формы и валидация
Оптимизация производительности
- Ленивая загрузка компонентов
- Code splitting в MDX
- Кэширование
- Оптимизация сборки
- Минификация
- Анализ размера бандла
- Server-side rendering
- Static site generation
- Incremental static regeneration
Доступность
- Семантическая разметка
- ARIA атрибуты
- Навигация с клавиатуры
- Screen readers
- Контраст и читаемость
- Альтернативный текст для изображений
- Тестирование доступности
Типизация и TypeScript
- Типы для MDX компонентов
- Типизация props
- Типы для метаданных
- Generic типы
- Типы для провайдеров
- Утилитарные типы
- Type guards
- Inference типов
Тестирование
- Unit тестирование MDX компонентов
- Snapshot тестирование
- Интеграционные тесты
- E2E тестирование
- Тестирование рендеринга
- Моки и стабы
- Coverage отчеты
- Тестовые утилиты
Миграция и совместимость
- Миграция с MDX v1 на v2
- Breaking changes
- Совместимость с различными версиями React
- Поддержка старых браузеров
- Polyfills
- Обратная совместимость
- Стратегии миграции больших проектов
Генерация контента
- Программная генерация MDX
- Шаблоны и макросы
- Автоматизация создания документов
- Парсинг MDX
- Трансформация контента
- Валидация сгенерированного контента
SEO и метатеги
- Заголовки страниц
- Мета описания
- Open Graph теги
- Twitter Cards
- Sitemap генерация
- Canonical URLs
- Robots meta tags
Интернационализация
- Многоязычный контент
- Структура файлов для i18n
- Локализация компонентов
- RTL поддержка
- Форматирование дат и чисел
- Переводы метаданных
- Переключение языков
Работа с изображениями
- Оптимизация изображений
- Responsive изображения
- Lazy loading
- Плейсхолдеры
- Форматы изображений
- CDN интеграция
- Галереи и слайдеры
- Zoom и лайтбоксы
Работа с медиа
- Встраивание видео
- Аудио файлы
- YouTube и Vimeo
- Адаптивные медиа
- Субтитры и транскрипты
- Плееры и управление
- Потоковое видео
Документация и блоги
- Структура документации
- Навигация и оглавление
- Предыдущая и следующая страница
- Поиск по документации
- Версионирование документации
- Changelog
- Блог на MDX
- Посты и пагинация
- Теги и категории
- RSS лента
Расширенные техники
- Макросы и преобразования
- AST манипуляции
- Кастомный парсер
- Препроцессинг
- Постпроцессинг
- Декораторы компонентов
- Композиция контента
- Условная компиляция
Безопасность
- XSS защита
- Санитизация HTML
- Безопасность пользовательского контента
- CSP заголовки
- Проверка входных данных
- Безопасные зависимости
- Аудит безопасности
Отладка и troubleshooting
- Дебаггинг MDX
- Инструменты разработчика
- Логирование и трейсинг
- Распространенные ошибки
- Решение конфликтов плагинов
- Проблемы совместимости
- Performance debugging
- Source maps
Продакшн развертывание
- Подготовка к деплою
- Статический хостинг
- CDN конфигурация
- Логирование ошибок
- A/B тестирование
Инструменты разработки
- MDX редакторы
- Подсветка синтаксиса в IDE
- Линтеры для MDX
- Форматтеры
- Превью и hot reload
- Плагины для редакторов
- CLI инструменты
- Автодополнение
API референс
- Compile API
- Evaluate API
- Runtime API
- Провайдер API
- Типы и интерфейсы
- Опции конфигурации
- Хуки и утилиты