{
  "url": "https://unifast.dev/ko/docs/guides/mdx/",
  "locale": "ko",
  "title": "MDX 사용하기",
  "description": "unifast로 MDX를 컴파일하여 Markdown 안에서 JSX 표현식과 import 문을 사용하고, React나 다른 JSX 런타임으로 렌더링합니다.",
  "section": "guides",
  "body": "MDX를 사용하면 Markdown 안에서 JSX 표현식과 import 문을 쓸 수 있습니다. unifast는 MDX를 JavaScript 모듈로 컴파일하며, 이 모듈은 React나 다른 JSX 런타임으로 렌더링할 수 있습니다.\n\n### 설치\n\n### 기본 사용법\n\n```ts\n\nconst source = `\n# Hello\n\nexport const meta = { title: \"My Page\" };\n`;\n\nconst result = compile(source, { inputKind: \"mdx\" });\n// result.output은 JavaScript 모듈 문자열입니다\n```\n\n### MDX의 동작 방식\n\nMDX는 Markdown에 두 가지 기능을 더합니다.\n\n1. **JSX 표현식** - 본문 안에서 컴포넌트를 사용할 수 있습니다.\n2. **ESM import/export** - 컴포넌트를 import하고 메타데이터를 export할 수 있습니다.\n\n컴파일러는 MDX를 다음 단계로 처리합니다.\n\n```\nMDX 소스\n  → Parse (Markdown + JSX + ESM)\n  → JSX/ESM 노드를 포함한 MdAst\n  → HAst로 로우어링\n  → JavaScript 모듈로 출력\n```\n\n출력 결과는 컴포넌트 주입을 위한 `components` prop을 받는 기본 export 함수를 가진 JavaScript 모듈입니다.\n\n### React와 함께 사용하기\n\n```ts\n\nconst source = `# Hello\\n\\nThis is **MDX**.`;\n\nconst result = compile(source, { inputKind: \"mdx\" });\nconst Component = compileToReact(result);\n\n// React 앱에서 렌더링\n\n```\n\n### MDX의 Frontmatter\n\nMDX를 frontmatter 플러그인과 조합해 메타데이터를 추출할 수 있습니다.\n\n```ts\n\nconst source = `---\ntitle: My Article\nauthor: Jane\n---\n\n# {frontmatter.title}\n\nWritten by {frontmatter.author}.\n`;\n\nconst result = compile(source, {\n  inputKind: \"mdx\",\n  plugins: [frontmatter()],\n});\n\nconsole.log(result.frontmatter);\n// { title: \"My Article\", author: \"Jane\" }\n```\n\n### 함께 보기\n\n- [compile()](/docs/packages/node/compile) - 전체 API 레퍼런스\n- [React 연동](/docs/guides/react) - MDX를 React로 렌더링하기",
  "alternates": [
    {
      "locale": "en",
      "url": "https://unifast.dev/docs/guides/mdx/",
      "api": "https://unifast.dev//api/docs/guides/mdx.json"
    },
    {
      "locale": "ja",
      "url": "https://unifast.dev/ja/docs/guides/mdx/",
      "api": "https://unifast.dev//api/ja/docs/guides/mdx.json"
    },
    {
      "locale": "zh-CN",
      "url": "https://unifast.dev/zh-CN/docs/guides/mdx/",
      "api": "https://unifast.dev//api/zh-CN/docs/guides/mdx.json"
    },
    {
      "locale": "zh-TW",
      "url": "https://unifast.dev/zh-TW/docs/guides/mdx/",
      "api": "https://unifast.dev//api/zh-TW/docs/guides/mdx.json"
    },
    {
      "locale": "ko",
      "url": "https://unifast.dev/ko/docs/guides/mdx/",
      "api": "https://unifast.dev//api/ko/docs/guides/mdx.json"
    },
    {
      "locale": "fr",
      "url": "https://unifast.dev/fr/docs/guides/mdx/",
      "api": "https://unifast.dev//api/fr/docs/guides/mdx.json"
    },
    {
      "locale": "it",
      "url": "https://unifast.dev/it/docs/guides/mdx/",
      "api": "https://unifast.dev//api/it/docs/guides/mdx.json"
    },
    {
      "locale": "es",
      "url": "https://unifast.dev/es/docs/guides/mdx/",
      "api": "https://unifast.dev//api/es/docs/guides/mdx.json"
    },
    {
      "locale": "pt-BR",
      "url": "https://unifast.dev/pt-BR/docs/guides/mdx/",
      "api": "https://unifast.dev//api/pt-BR/docs/guides/mdx.json"
    },
    {
      "locale": "de",
      "url": "https://unifast.dev/de/docs/guides/mdx/",
      "api": "https://unifast.dev//api/de/docs/guides/mdx.json"
    },
    {
      "locale": "ru",
      "url": "https://unifast.dev/ru/docs/guides/mdx/",
      "api": "https://unifast.dev//api/ru/docs/guides/mdx.json"
    },
    {
      "locale": "hi",
      "url": "https://unifast.dev/hi/docs/guides/mdx/",
      "api": "https://unifast.dev//api/hi/docs/guides/mdx.json"
    },
    {
      "locale": "id",
      "url": "https://unifast.dev/id/docs/guides/mdx/",
      "api": "https://unifast.dev//api/id/docs/guides/mdx.json"
    },
    {
      "locale": "tr",
      "url": "https://unifast.dev/tr/docs/guides/mdx/",
      "api": "https://unifast.dev//api/tr/docs/guides/mdx.json"
    },
    {
      "locale": "vi",
      "url": "https://unifast.dev/vi/docs/guides/mdx/",
      "api": "https://unifast.dev//api/vi/docs/guides/mdx.json"
    }
  ]
}