{
  "url": "https://unifast.dev/ru/docs/packages/vite/overview/",
  "locale": "ru",
  "title": "@unifast/vite",
  "description": "Плагин Vite для unifast — преобразование файлов Markdown и MDX в JS-модули",
  "section": "packages",
  "body": "## Обзор\n\n`@unifast/vite` — плагин Vite, который преобразует файлы `.md` и `.mdx` в JavaScript-модули. Он интегрирует компилятор Markdown/MDX unifast в конвейер сборки Vite, позволяя импортировать файлы Markdown напрямую в приложении.\n\n## Установка\n\n`@unifast/node` является peer-зависимостью (необязательной) — когда он доступен, плагин использует нативный компилятор на Rust для максимальной производительности. Без него файлы `.md` переключаются на базовую отрисовку HTML, а файлы `.mdx` требуют его наличия.\n\n## Быстрый старт\n\n```ts\n// vite.config.ts\n\nexport default defineConfig({\n  plugins: [\n    unifast({\n      md: {\n        // параметры компиляции для файлов .md\n      },\n      mdx: {\n        // параметры компиляции для файлов .mdx\n      },\n    }),\n  ],\n});\n```\n\n```ts\n// App.tsx\n\nconsole.log(doc.html);         // скомпилированная строка HTML\nconsole.log(doc.frontmatter);  // распарсенный объект frontmatter\nconsole.log(doc.toc);          // элементы оглавления\n```\n\n## Экспорты модулей\n\n### Файлы `.md`\n\nКаждый файл `.md` преобразуется в модуль со следующими экспортами:\n\n| Экспорт | Тип | Описание |\n|--------|------|-------------|\n| `html` | `string` | Скомпилированная строка HTML |\n| `frontmatter` | `Record<string, unknown>` | Распарсенные метаданные frontmatter |\n| `toc` | `TocEntry[]` | Извлечённое оглавление |\n| `default` | `object` | Объект, содержащий `html`, `frontmatter` и `toc` |\n\n### Файлы `.mdx`\n\nКаждый файл `.mdx` компилируется в JSX-модуль с использованием React `jsx-runtime`. Он экспортирует React-компонент по умолчанию вместе с `frontmatter` и `toc`.\n\n## Сводка экспортов\n\n| Экспорт | Вид | Описание |\n|--------|------|-------------|\n| `default` (unifastPlugin) | функция | Фабрика плагина Vite |\n| `UnifastPluginOptions` | тип | Интерфейс параметров плагина |",
  "alternates": [
    {
      "locale": "en",
      "url": "https://unifast.dev/docs/packages/vite/overview/",
      "api": "https://unifast.dev//api/docs/packages/vite/overview.json"
    },
    {
      "locale": "ja",
      "url": "https://unifast.dev/ja/docs/packages/vite/overview/",
      "api": "https://unifast.dev//api/ja/docs/packages/vite/overview.json"
    },
    {
      "locale": "zh-CN",
      "url": "https://unifast.dev/zh-CN/docs/packages/vite/overview/",
      "api": "https://unifast.dev//api/zh-CN/docs/packages/vite/overview.json"
    },
    {
      "locale": "zh-TW",
      "url": "https://unifast.dev/zh-TW/docs/packages/vite/overview/",
      "api": "https://unifast.dev//api/zh-TW/docs/packages/vite/overview.json"
    },
    {
      "locale": "ko",
      "url": "https://unifast.dev/ko/docs/packages/vite/overview/",
      "api": "https://unifast.dev//api/ko/docs/packages/vite/overview.json"
    },
    {
      "locale": "fr",
      "url": "https://unifast.dev/fr/docs/packages/vite/overview/",
      "api": "https://unifast.dev//api/fr/docs/packages/vite/overview.json"
    },
    {
      "locale": "it",
      "url": "https://unifast.dev/it/docs/packages/vite/overview/",
      "api": "https://unifast.dev//api/it/docs/packages/vite/overview.json"
    },
    {
      "locale": "es",
      "url": "https://unifast.dev/es/docs/packages/vite/overview/",
      "api": "https://unifast.dev//api/es/docs/packages/vite/overview.json"
    },
    {
      "locale": "pt-BR",
      "url": "https://unifast.dev/pt-BR/docs/packages/vite/overview/",
      "api": "https://unifast.dev//api/pt-BR/docs/packages/vite/overview.json"
    },
    {
      "locale": "de",
      "url": "https://unifast.dev/de/docs/packages/vite/overview/",
      "api": "https://unifast.dev//api/de/docs/packages/vite/overview.json"
    },
    {
      "locale": "ru",
      "url": "https://unifast.dev/ru/docs/packages/vite/overview/",
      "api": "https://unifast.dev//api/ru/docs/packages/vite/overview.json"
    },
    {
      "locale": "hi",
      "url": "https://unifast.dev/hi/docs/packages/vite/overview/",
      "api": "https://unifast.dev//api/hi/docs/packages/vite/overview.json"
    },
    {
      "locale": "id",
      "url": "https://unifast.dev/id/docs/packages/vite/overview/",
      "api": "https://unifast.dev//api/id/docs/packages/vite/overview.json"
    },
    {
      "locale": "tr",
      "url": "https://unifast.dev/tr/docs/packages/vite/overview/",
      "api": "https://unifast.dev//api/tr/docs/packages/vite/overview.json"
    },
    {
      "locale": "vi",
      "url": "https://unifast.dev/vi/docs/packages/vite/overview/",
      "api": "https://unifast.dev//api/vi/docs/packages/vite/overview.json"
    }
  ]
}