框架集成
Vite
Fumadocs MDX 的 Vite 集成指南
安装
npm i fumadocs-mdx fumadocs-core @types/mdx配置
source.config.ts
import { defineDocs } from 'fumadocs-mdx/config';
export const docs = defineDocs({
dir: 'content/docs',
});vite.config.ts
import { defineConfig } from 'vite';
import mdx from 'fumadocs-mdx/vite';
import * as MdxConfig from './source.config';
export default defineConfig({
plugins: [mdx(MdxConfig)],
});导入别名(可选)
在 tsconfig.json 中配置 TypeScript 路径映射:
{
"compilerOptions": {
"paths": {
"collections/*": [".source/*"]
}
}
}Fumadocs 集成
创建 app/lib/source.ts 连接 Fumadocs:
import { docs } from 'collections/server';
import { loader } from 'fumadocs-core/source';
export const source = loader({
baseUrl: '/docs',
source: docs.toFumadocsSource(),
});
.source文件夹会在开发或生产构建时自动生成。内容文件放在content/docs目录中。