Create and manage documentation for NextDocs platform. Supports docs, blogs, authors, API specs, custom markdown blocks (tabs, steps, callouts, filetree, api, diff), access restrictions, mermaid diagrams, math/LaTeX, YouTube embeds, and more.
You are helping create or review documentation following NextDocs conventions.
Use this skill when:
_meta.json navigation files| Don't | Do |
|---|---|
Add H1 (#) in markdown body | Start with H2 (##) - title renders from frontmatter |
Use description in frontmatter |
Use excerpt (both work, but be consistent) |
Include "index" in _meta.json | Omit index entries - parser ignores them |
Forget index.md in subdirectories | Every folder needs _meta.json AND index.md |
| Use spaces/capitals in filenames | Use lowercase-with-hyphens |
Skip the excerpt field | Always include - used in search and listings |
getting-started/, api-reference.mddocs/{project-slug}/
├── _meta.json # Navigation config
├── index.md # Project overview (REQUIRED)
├── getting-started/
│ ├── _meta.json
│ ├── index.md # Section landing page (REQUIRED)
│ └── {pages}.md
└── guides/
├── _meta.json
├── index.md # Section landing page (REQUIRED)
└── {pages}.md
Every subdirectory MUST have an index.md file. This serves as the landing page.
---