Fumadocs

快速开始

Fumadocs 入门

介绍

Fumadocs (Foo-ma docs) 是一个 文档框架,旨在快速、灵活,并与您的 React 框架无缝集成。

Fumadocs 包含不同的部分:

Fumadocs Core

处理大部分逻辑,包括文档搜索、内容源适配器和 Markdown 扩展。

Fumadocs UI

Fumadocs 的默认主题为文档站点提供美观的外观和交互式组件。

Content Source

您的内容来源,可以是 CMS 或本地数据层,如 Fumadocs MDX(官方内容源)。

Fumadocs CLI

一个命令行工具,用于安装 UI 组件和自动化任务,有助于自定义布局。

想了解更多?

阅读我们深入的 什么是 Fumadocs 介绍。

术语

Markdown/MDX: Markdown 是一种用于创建格式化文本的标记语言。Fumadocs 原生支持 Markdown 和 MDX(Markdown 的超集)。

Bun 一个 JavaScript 运行时,我们用它来运行脚本。

对 React.js 的一些基本知识将有助于进一步自定义。

自动安装

需要 Node.js 20 的最低版本。

npm create fumadocs-app

它将询问您要使用的内置模板:

  • React.js 框架:Next.js、Waku、React Router、Tanstack Start。
  • 内容源:Fumadocs MDX。

一个新的 fumadocs 应用将被初始化。现在您可以开始开发!

从现有代码库开始?

您可以跟随 手动安装 指南开始。

享受过程!

在 docs 文件夹中创建您的第一个 MDX 文件。

content/docs/index.mdx
---
title: Hello World
---

## Yo what's up

在开发模式下运行应用,并查看 http://localhost:3000/docs。

npm run dev

常见问题

您可能遇到的一些常见问题。

对于 Vite

对于 Next.js

了解更多

新来这里?别担心,我们欢迎您的问题。

如果您发现任何令人困惑的内容,请在 Github Discussion 上提供反馈!

编写内容

对于编写文档,请确保阅读:

特殊需求

How is this guide?

Last updated on