Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

VitePress

vitepress.dev

  • Free plan
  • Open source
  • Windows
  • macOS
  • Linux
  • Web
  • API
  • Self-hosted
8.3 Club score Visit vitepress.dev

What VitePress is

VitePress is a static site generator that turns Markdown into themed HTML pages for content-focused websites. Its default theme is geared toward technical documentation, and it can also support blogs, portfolios, and marketing sites. The Vite-powered development server reflects edits in under 100 ms without requiring a page reload. Markdown support includes frontmatter, tables, syntax highlighting, and advanced code block options. Pages are processed as Vue components, so authors can use Vue templates, imported components, and in-page component logic.

Production builds pre-render static HTML in Node.js, then use client-side routing for subsequent navigation. VitePress supports custom themes, Vite plugins, build-time data loading, and dynamically generated routes. It can be installed as a development dependency using npm, pnpm, yarn, bun, or deno, and includes a command-line setup wizard. It is free under the MIT License. Getting started requires Node.js 22 or higher, and custom theme code must be compatible with server-side rendering.

Who it suits

VitePress suits developers and teams building technical documentation, blogs, portfolios, or marketing sites from Markdown. It is a fit for projects whose maintainers can work with Node.js 22 or higher and server-rendering constraints.

Good to know, and what to watch

  • Free under the MIT License
  • Markdown supports syntax highlighting and advanced code blocks
  • Vue templates and imported components work in Markdown pages
  • Supports custom themes, plugins, and generated routes
  • Requires Node.js 22 or higher
  • Custom theme code must support server-side rendering
  • Documentation links to both 2.0.0-alpha.20 and 1.6.4

Free open-source software

Free

VitePress

Free

Free plan

Getting started

  1. Install VitePress as a development dependency with npm, pnpm, yarn, bun or deno
  2. Ensure Node.js version 22 or higher is available
  3. Run the included command-line setup wizard
  4. Write site content in Markdown using the supported features
  5. Customize themes, plugins, data loading or routes as needed
  6. Deploy through a supported host such as Netlify, Vercel or GitHub Pages

Limits to check

The VitePress plan costs nothing and requires Node.js 22 or higher. Custom theme code must be compatible with server-side rendering because production builds pre-render the app in Node.js.

The verdict

VitePress combines Markdown authoring with Vue components and customization options for several types of content sites. Check the Node.js prerequisite and server-side rendering requirement before choosing it.

Questions people ask

How much does VitePress cost?

VitePress costs nothing and is released under the MIT License.

Which platforms support VitePress?

The listed platforms are Linux, macOS, web and Windows.

What content can it create?

It converts Markdown into themed static HTML for technical documentation, blogs, portfolios and marketing sites.

Can Markdown pages use Vue?

Yes. Markdown pages are processed as Vue components and can include templates, imported components and in-page logic.

What is required to install it?

Installation uses npm, pnpm, yarn, bun or deno, and the getting-started guide requires Node.js 22 or higher.

Can sites use a custom domain?

Yes. Custom domain support is listed.

What the maker publishes

Build-time data
Data-loader files ending in .data.js or .data.ts can fetch or generate data during builds and serialize it into the output bundle. source
CLI
The CLI includes dev, build, preview and init commands with options for ports, base paths, CORS, output directories and experimental MPA builds. source
CMS integration
The CMS guide documents authenticated API fetching with loadEnv, dynamic paths generation and rendering fetched content. source
Company founder
VoidZero identifies Evan You as its founder and CEO. source
Company founding and headquarters
Dealroom lists VoidZero as founded in 2020 and headquartered in Palo Alto, United States. source
Company size and funding
Dealroom lists fewer than 100 employees and total disclosed equity funding in the $10–50 million range. source
Current documentation versions
The documentation site links to version 2.0.0-alpha.20 and to the 1.6.4 documentation. source
Custom domain
Yes source
Customization and data
VitePress supports custom themes, Vite plugins, build-time data loading, and dynamically generated routes. source
Deployment integrations
The deployment guide provides instructions for Netlify, Vercel, Cloudflare Pages, AWS Amplify, Render, GitHub Pages, GitLab Pages, Azure, Firebase, and other hosts. source
Deployment integrations
Official deployment guidance covers GitHub Pages, GitLab Pages, Netlify, Vercel, Cloudflare Pages, AWS Amplify, Render, Azure, Firebase, Heroku, nginx and other hosts. source
Development speed
Its Vite development server reflects edits in under 100 milliseconds without a full page reload. source
Free plan
Yes source
Installation
VitePress can be installed as a development dependency with npm, pnpm, yarn, bun, or deno and includes a command-line setup wizard. source
License
The GitHub repository distributes VitePress under the MIT license. source
Limit: application workloads
An independent comparison recommends a full framework such as Vue or Nuxt when a site is primarily an interactive application rather than content with limited interactivity. source
Limit: blogging
Docsio reports that VitePress lacks built-in tags, RSS, archives and comments for blogs. source
Limit: customization learning curve
Docsio says deeper theme customization requires Vue components and slot overrides rather than only configuration or CSS edits. source
Limit: plugin ecosystem
Docsio describes the plugin ecosystem as smaller than Docusaurus and says advanced search, analytics and OpenAPI needs may require custom work. source
Limit: sidebar maintenance
Docsio notes that new Markdown files do not automatically appear in the sidebar without manual configuration or a community plugin. source
Limit: versioning
Docsio says VitePress has no first-party documentation versioning and teams must use branches, folders or multiple deployments. source
Local search
The default theme provides fuzzy browser-side full-text search through MiniSearch. source
Markdown features
Built-in Markdown features include frontmatter, tables, syntax highlighting, and advanced code block options. source
Markdown features
Built-in Markdown support includes frontmatter, tables and syntax-highlighted code blocks. source

Checked against the maker's pages on 15 Oct 2026.