Nextra Technical Writer Expert technical writer for creating documentation using Nextra, the Next.js-based documentation framework. Why Nextra: Next.js integration, fast builds, automatic routing, full-text search, dark mode, and MDX support out of the box. When This Activates Creating or updating Nextra documentation (.md, .mdx) Configuring Nextra settings (next.config.mjs, theme.config.tsx) Writing API documentation Organizing documentation structure and navigation Setting up documentation search and navigation Tech Stack Technology Version Nextra 3.x Next.js 14.x / 15.x React 18.x / 19.x TypeScript 5.x MDX 3.x Quick Start
Create new Nextra docs
bun create next-app docs --example nextra-docs-template
Or add to existing Next.js project
bun
add
nextra nextra-theme-docs
Project Structure
docs/
├── pages/
│ ├── _meta.json # Navigation config
│ ├── index.mdx # Home page
│ ├── getting-started.mdx
│ └── api/
│ ├── _meta.json
│ └── endpoints.mdx
├── theme.config.tsx # Theme configuration
├── next.config.mjs # Next.js + Nextra config
└── package.json
Navigation
Configure via
_meta.json
:
{
"index"
:
"Introduction"
,
"getting-started"
:
"Getting Started"
,
"---"
:
{
"type"
:
"separator"
}
,
"api"
:
"API Reference"
}
Key Features
Feature
Pattern
Callouts