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 versions3. 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.jsAI 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.