Skills
Skill 12 of 19
VitePress static site generator powered by Vite and Vue. Use when building documentation sites, configuring themes, or writing Markdown with Vue components.
1 minute · 230 words · 6 sections
Install
npx skills add antfu/skills --skill vitepressnpx skills add antfu/skillsThe first command installs just this skill, by the name in its SKILL.md; the second installs the whole repository.
VitePress is a Static Site Generator (SSG) built on Vite and Vue 3. It takes Markdown content, applies a theme, and generates static HTML that becomes an SPA for fast navigation. Perfect for documentation, blogs, and marketing sites.
Key Characteristics:
.md filesBefore working with VitePress projects:
.vitepress/config.ts for site configuration.vitepress/theme/ for custom theme extensionspublic/ directory contains static assets served as-isThe skill is based on VitePress 1.x, generated at 2026-01-28.
| Topic | Description | Reference |
|---|---|---|
| Configuration | Config file setup, defineConfig, site metadata | core-config (opens in a new tab) |
| CLI | Command-line interface: dev, build, preview, init | core-cli (opens in a new tab) |
| Routing | File-based routing, source directory, rewrites | core-routing (opens in a new tab) |
| Markdown | Frontmatter, containers, tables, anchors, includes | core-markdown (opens in a new tab) |
| Topic | Description | Reference |
|---|---|---|
| Code Blocks | Syntax highlighting, line highlighting, diffs, focus | features-code-blocks (opens in a new tab) |
| Vue in Markdown | Components, script setup, directives, templating | features-vue (opens in a new tab) |
| Data Loading | Build-time data loaders, createContentLoader | features-data-loading (opens in a new tab) |
| Dynamic Routes | Generate pages from data, paths loader files | features-dynamic-routes (opens in a new tab) |
| Topic | Description | Reference |
|---|---|---|
| Theme Config | Nav, sidebar, search, social links, footer | theme-config (opens in a new tab) |
| Customization | CSS variables, slots, fonts, global components | theme-customization (opens in a new tab) |
| Custom Theme | Building themes from scratch, theme interface | theme-custom (opens in a new tab) |
| Topic | Description | Reference |
|---|---|---|
| Internationalization | Multi-language sites, locale configuration | advanced-i18n (opens in a new tab) |
| SSR Compatibility | Server-side rendering, ClientOnly, dynamic imports | advanced-ssr (opens in a new tab) |
| Topic | Description | Reference |
|---|---|---|
| Deployment | GitHub Pages, Netlify, Vercel, Cloudflare, Nginx | recipes-deploy (opens in a new tab) |
main, last pushed 23 June 2026.SKILL.md, not by matching a directory convention. One layout observed: skills/*/SKILL.md./antfu/skills.md, and each skill at its own .md URL.15 files · 59 KB
Everything this skill ships beside its prose. All of it is set here, as subchapters of skill 12.
Documentation the agent loads on demand, rather than up front.
Everything else published alongside the skill.