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.
View source

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:

mhaibaraai.cn

Tech blog and knowledge base

@movk/core

Vue.js utilities and composables

@movk/nuxt

Modular Nuxt 4 toolkit with schema-driven forms, UI components and utilities

@movk/maplibre

Declarative MapLibre GL wrapper, no access token required

@movk/sigma

Knowledge graph visualization Nuxt module built on sigma v4

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 in app.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.

FeatureHow to enablePurpose
AI ChatSet the AI_API_KEY environment variable, or aiChat.enabled: trueAn AI assistant beside the docs, see AI Chat
Component docsmovkNuxtDocs.componentDocs: trueProps, Slots and Emits tables and live examples generated from Vue source
MermaidmovkNuxtDocs.mermaid: trueFlowcharts, sequence diagrams and more in code blocks, see Mermaid
InternationalizationAdd @nuxtjs/i18n to modulesMultilingual content and a language switcher, see Internationalization
Accessibility checksmovkNuxtDocs.a11y: trueCheck pages with @nuxt/a11y during development

Next steps

Installation

Create a new site from a template, or add the layer to an existing Nuxt project.

Migrating from v2

Every breaking change in v3, with the new way to write it.
Copyright © 2024 - 2026