{
  "url": "https://unifast.dev/ko/docs/guides/vite/",
  "locale": "ko",
  "title": "Vite 연동",
  "description": "@unifast/vite로 빌드 타임에 Markdown과 MDX 파일을 컴파일하고 Vite 애플리케이션에서 직접 import합니다.",
  "section": "guides",
  "body": "`@unifast/vite`는 빌드 타임에 Markdown과 MDX 파일을 컴파일해 주는 Vite 플러그인입니다. 애플리케이션에서 `.md`와 `.mdx` 파일을 직접 import할 수 있습니다.\n\n### 설치\n\n### 설정\n\nVite 설정 파일에 플러그인을 추가합니다.\n\n```ts\n// vite.config.ts\n\nexport default defineConfig({\n  plugins: [\n    unifast({\n      // 선택 사항: compile 옵션 전달\n      plugins: [],\n    }),\n  ],\n});\n```\n\n### Markdown import\n\n설정이 끝나면 `.md` 파일을 곧바로 import할 수 있습니다.\n\n```ts\n\nconsole.log(content.html);         // 컴파일된 HTML 문자열\nconsole.log(content.frontmatter);  // 파싱된 frontmatter\nconsole.log(content.toc);          // 목차\n```\n\nimport된 모듈은 다음을 제공합니다.\n\n| 속성 | 타입 | 설명 |\n|----------|------|-------------|\n| `html` | `string` | 컴파일된 HTML 출력 |\n| `frontmatter` | `Record<string, unknown>` | 파싱된 frontmatter 메타데이터 |\n| `toc` | `TocEntry[]` | 추출된 목차 |\n\n### 플러그인과 함께 사용\n\nVite 플러그인 옵션을 통해 플러그인을 전달합니다.\n\n```ts\n// vite.config.ts\n\nexport default defineConfig({\n  plugins: [\n    unifast({\n      plugins: [frontmatter(), gfm(), syntect()],\n    }),\n  ],\n});\n```\n\n프로젝트 내 모든 Markdown/MDX import에 지정한 플러그인이 자동으로 적용됩니다.\n\n### MDX 지원\n\nMDX 파일은 기본 React 컴포넌트를 export하는 JavaScript 모듈로 컴파일됩니다.\n\n```tsx\n\nfunction Page() {\n  return ;\n}\n```\n\n### 핫 모듈 교체(HMR)\n\nVite 플러그인은 HMR을 지원합니다. `.md`나 `.mdx` 파일을 편집하면 전체 페이지를 새로고침하지 않고도 페이지가 갱신됩니다.\n\n### 함께 보기\n\n- [compile()](/docs/packages/node/compile) - 내부적으로 사용되는 compile API\n- [React 연동](/docs/guides/react) - 컴파일된 콘텐츠를 React로 렌더링하기",
  "alternates": [
    {
      "locale": "en",
      "url": "https://unifast.dev/docs/guides/vite/",
      "api": "https://unifast.dev//api/docs/guides/vite.json"
    },
    {
      "locale": "ja",
      "url": "https://unifast.dev/ja/docs/guides/vite/",
      "api": "https://unifast.dev//api/ja/docs/guides/vite.json"
    },
    {
      "locale": "zh-CN",
      "url": "https://unifast.dev/zh-CN/docs/guides/vite/",
      "api": "https://unifast.dev//api/zh-CN/docs/guides/vite.json"
    },
    {
      "locale": "zh-TW",
      "url": "https://unifast.dev/zh-TW/docs/guides/vite/",
      "api": "https://unifast.dev//api/zh-TW/docs/guides/vite.json"
    },
    {
      "locale": "ko",
      "url": "https://unifast.dev/ko/docs/guides/vite/",
      "api": "https://unifast.dev//api/ko/docs/guides/vite.json"
    },
    {
      "locale": "fr",
      "url": "https://unifast.dev/fr/docs/guides/vite/",
      "api": "https://unifast.dev//api/fr/docs/guides/vite.json"
    },
    {
      "locale": "it",
      "url": "https://unifast.dev/it/docs/guides/vite/",
      "api": "https://unifast.dev//api/it/docs/guides/vite.json"
    },
    {
      "locale": "es",
      "url": "https://unifast.dev/es/docs/guides/vite/",
      "api": "https://unifast.dev//api/es/docs/guides/vite.json"
    },
    {
      "locale": "pt-BR",
      "url": "https://unifast.dev/pt-BR/docs/guides/vite/",
      "api": "https://unifast.dev//api/pt-BR/docs/guides/vite.json"
    },
    {
      "locale": "de",
      "url": "https://unifast.dev/de/docs/guides/vite/",
      "api": "https://unifast.dev//api/de/docs/guides/vite.json"
    },
    {
      "locale": "ru",
      "url": "https://unifast.dev/ru/docs/guides/vite/",
      "api": "https://unifast.dev//api/ru/docs/guides/vite.json"
    },
    {
      "locale": "hi",
      "url": "https://unifast.dev/hi/docs/guides/vite/",
      "api": "https://unifast.dev//api/hi/docs/guides/vite.json"
    },
    {
      "locale": "id",
      "url": "https://unifast.dev/id/docs/guides/vite/",
      "api": "https://unifast.dev//api/id/docs/guides/vite.json"
    },
    {
      "locale": "tr",
      "url": "https://unifast.dev/tr/docs/guides/vite/",
      "api": "https://unifast.dev//api/tr/docs/guides/vite.json"
    },
    {
      "locale": "vi",
      "url": "https://unifast.dev/vi/docs/guides/vite/",
      "api": "https://unifast.dev//api/vi/docs/guides/vite.json"
    }
  ]
}