VitePress

VitePress is the Vue team's documentation generator: Markdown in, a fast single-page application out, with a default theme most library docs can ship unchanged. The guides below cover what teams need once the site is real — tuning the built-in local search so its index stays small, publishing several major versions side by side without a plugin, and moving an existing MkDocs site across with every URL intact.

Its defining trade-off is client-side navigation. Pages hydrate as a Vue app, which makes moving between pages near-instant and costs more JavaScript than Starlight on the first page. The comparison guide measures both on the same 500 pages, and the rest of the list notes where that model helps and where it gets in the way.

Every guide reports numbers from a real site: index size, build time, page weight.

Choosing the Right Static Site Generator for Production

Comparing Docs Framework Build TimesComparisonBenchmark Docusaurus, Starlight and VitePress on the same 2,000-page docs corpus: cold and warm builds, memory, output size and what drives each number.
VitePress vs Starlight for Vue and Astro TeamsComparisonVitePress and Starlight compared on the same 500-page docs set: build time, page weight, search, i18n, customisation and which team each one suits.
VitePress for Library DocumentationConceptSet up VitePress docs next to a library's source: generated API reference from TypeDoc, live code samples, versioned deploys and sub-20-second builds.
Adding Local Search to a VitePress SiteHow-toTurn on VitePress's built-in local search, tune what it indexes and how it ranks, keep the index small on large docs, and measure its cost to the page.
Migrating MkDocs Documentation to VitePressHow-toMove an MkDocs Material site to VitePress: convert admonitions, tabs and nav, keep every URL working, and compare build time and page weight after.
Versioning VitePress Documentation Without a PluginHow-toPublish several versions of VitePress docs side by side using git branches, a version switcher and one deploy, with canonicals pointing at the latest.

7 guides use VitePress in depth; each is listed below under the section it belongs to.

Core Web Vitals Optimization for SSGs

Code Splitting and Module Preload in Vite-Based SSGsHow-toFind JavaScript that loads on every page of an Astro or VitePress site, split it with dynamic imports and manualChunks, and keep modulepreload hints honest.

Topic pages give the wider context for each group; the numbers count only guides that use this tool in depth.

Often used with VitePress

Astro2 shared guidesIslands, content collections, astro:assets and deployment.
Starlight2 shared guidesAstro-based docs: overrides, translation and migration in.
Docusaurus1 shared guidesVersioned docs, faster builds and migration out.