Introduction
Movk Nuxt Docs is a Nuxt Layer you can extend to get typography, navigation, search, SEO and AI features for a documentation site. This page explains what it suits, what is included by default and what you can turn on.
What is Movk Nuxt Docs
Movk Nuxt Docs is a Nuxt Layer published as the npm package @movk/nuxt-docs. Add extends: ['@movk/nuxt-docs'] to nuxt.config.ts and your project becomes a complete documentation site: header, sidebar, table of contents, full-text search, dark mode, SEO and OG images. All you write is Markdown in content/docs/.
It is built on Nuxt 4, Nuxt UI and Nuxt Content. Pages support MDC syntax, so you can use Vue components directly in Markdown.
These sites are built with the theme:
Included by default
Available right after installation, with no extra configuration:
- Editorial typography: serif headings, a numbered section bar, a warm paper background and a vermilion primary color; adjust it or switch back to sans-serif in Theme and Fonts
- Navigation: the sidebar is generated from the
content/docs/directory; header links and sidebar categories are declared inapp.config.ts, see Navigation and Categories - Search: ⌘K full-text search that shows recently visited pages of the current locale when empty
- SEO: sitemap, robots, Schema.org structured data and OG images generated at build time
- MCP Server: editors and AI assistants read the docs in a structured way through
/mcp, see MCP Server - AI-readable content:
llms.txt, a Markdown version of every page (/raw/**.md) and agent discovery endpoints - Git integration: last commit time, edit links and commit history components
Opt-in features
These features are off by default. Their dependencies are optional peers that you install when you enable them; if a dependency is missing, the build fails with the install command. See Feature Flags.
| Feature | How to enable | Purpose |
|---|---|---|
| AI Chat | Set the AI_API_KEY environment variable, or aiChat.enabled: true | An AI assistant beside the docs, see AI Chat |
| Component docs | movkNuxtDocs.componentDocs: true | Props, Slots and Emits tables and live examples generated from Vue source |
| Mermaid | movkNuxtDocs.mermaid: true | Flowcharts, sequence diagrams and more in code blocks, see Mermaid |
| Internationalization | Add @nuxtjs/i18n to modules | Multilingual content and a language switcher, see Internationalization |
| Accessibility checks | movkNuxtDocs.a11y: true | Check pages with @nuxt/a11y during development |