ConfigsApr 8, 2026·2 min read

Docusaurus — Build AI Tool Documentation Sites

Meta's documentation framework used by major AI projects. Docusaurus creates fast, SEO-friendly docs sites with MDX, versioning, i18n, and Algolia search built in.

SC
Script Depot · Community
Quick Use

Use it first, then decide how deep to go

This block should tell both the user and the agent what to copy, install, and apply first.

npx create-docusaurus@latest my-docs classic
cd my-docs
npm start
# Docs site at http://localhost:3000

What is Docusaurus?

Docusaurus is Meta's open-source documentation framework, used by hundreds of AI projects (LangChain, Hugging Face, Supabase, Playwright). It generates fast, SEO-optimized static sites from Markdown/MDX with built-in versioning, i18n, blog, and Algolia search. If you are building an AI tool, MCP server, or SDK, Docusaurus is the standard choice for documentation.

Answer-Ready: Docusaurus is Meta's documentation framework used by LangChain, Hugging Face, and 100+ AI projects. Static site generator from MDX with versioning, i18n, Algolia search, and plugin ecosystem. Fast, SEO-friendly, and free. 58k+ GitHub stars.

Best for: AI tool creators needing professional documentation. Works with: Any project, GitHub Pages, Vercel, Netlify. Setup time: Under 3 minutes.

Core Features

1. MDX (Markdown + React)

# Getting Started

Install the SDK:

```bash
pip install my-ai-tool
```python from my_tool import Agent agent = Agent() ``` ```javascript import { Agent } from 'my-tool'; const agent = new Agent(); ``` ```

2. Versioning

npm run docusaurus docs:version 2.0
# Creates versioned snapshot of current docs
# Users can switch between versions

3. i18n (Internationalization)

// docusaurus.config.js
module.exports = {
  i18n: {
    defaultLocale: 'en',
    locales: ['en', 'zh', 'ja', 'ko'],
  },
};

4. Algolia Search

themeConfig: {
  algolia: {
    appId: 'YOUR_APP_ID',
    apiKey: 'YOUR_SEARCH_KEY',
    indexName: 'your-docs',
  },
},

5. Blog + Docs Combined

my-docs/
  docs/          # Documentation pages
  blog/          # Blog posts
  src/pages/     # Custom pages
  docusaurus.config.js

AI Projects Using Docusaurus

Project Stars
LangChain 100k+
Hugging Face 30k+
Supabase 75k+
Playwright 68k+
Redux 60k+
Jest 44k+

FAQ

Q: How does it compare to MkDocs? A: Docusaurus uses React (MDX), MkDocs uses Python (Jinja2). Docusaurus has better versioning and plugin ecosystem. MkDocs is simpler for Python-only teams.

Q: Is it free to host? A: Yes, deploy to GitHub Pages, Vercel, or Netlify for free.

Q: Can I customize the theme? A: Yes, full theme customization via CSS, React components, and the plugin system.

🙏

Source & Thanks

Created by Meta. Licensed under MIT.

facebook/docusaurus — 58k+ stars

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets