VitePress 静态站点生成器 - 基于 Vite 和 Vue 3 的快速文档与博客工具

vitepress by antfu/skills

5,000 周安装量

4,300 GitHub Stars

安装命令

npx skills add https://github.com/antfu/skills --skill vitepress

🇨🇳中文介绍

VitePress 是一个基于 Vite 和 Vue 3 构建的静态站点生成器 (SSG)。它接收 Markdown 内容，应用主题，并生成静态 HTML，这些 HTML 会成为一个单页应用 (SPA)，以实现快速导航。非常适合文档、博客和营销网站。

主要特点：

基于 .md 文件的文件路由
Vue 组件可直接在 Markdown 中使用
快速的热模块替换 (HMR)，即时更新 (<100ms)
为文档优化的默认主题
内置搜索（本地或 Algolia）

在使用 VitePress 项目之前：

检查 .vitepress/config.ts 以了解站点配置
查看 .vitepress/theme/ 以了解自定义主题扩展
public/ 目录包含按原样提供的静态资源

此技能基于 VitePress 1.x，生成于 2026-01-28。

核心

主题	描述	参考链接

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

主题	描述	参考链接
代码块	语法高亮、行高亮、差异对比、聚焦	features-code-blocks
Markdown 中的 Vue	组件、script setup、指令、模板	features-vue
数据加载	构建时数据加载器、createContentLoader	features-data-loading
动态路由	从数据生成页面、路径加载器文件	features-dynamic-routes

主题	描述	参考链接
主题配置	导航栏、侧边栏、搜索、社交链接、页脚	theme-config
自定义	CSS 变量、插槽、字体、全局组件	theme-customization
自定义主题	从零开始构建主题、主题接口	theme-custom

主题	描述	参考链接
国际化	多语言站点、区域设置配置	advanced-i18n
SSR 兼容性	服务端渲染、ClientOnly、动态导入	advanced-ssr

主题	描述	参考链接
部署	GitHub Pages、Netlify、Vercel、Cloudflare、Nginx	recipes-deploy

🇺🇸English

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:

File-based routing with .md files
Vue components work directly in Markdown
Fast HMR with instant updates (<100ms)
Default theme optimized for documentation
Built-in search (local or Algolia)

Before working with VitePress projects:

Check .vitepress/config.ts for site configuration
Look at .vitepress/theme/ for custom theme extensions
The public/ directory contains static assets served as-is

The skill is based on VitePress 1.x, generated at 2026-01-28.

Core

Topic	Description	Reference
Configuration	Config file setup, defineConfig, site metadata	core-config
CLI	Command-line interface: dev, build, preview, init	core-cli
Routing	File-based routing, source directory, rewrites	core-routing
Markdown	Frontmatter, containers, tables, anchors, includes	core-markdown

Features

Code & Content

Topic	Description	Reference
Code Blocks	Syntax highlighting, line highlighting, diffs, focus	features-code-blocks
Vue in Markdown	Components, script setup, directives, templating	features-vue
Data Loading	Build-time data loaders, createContentLoader	features-data-loading
Dynamic Routes	Generate pages from data, paths loader files	features-dynamic-routes

Theme

Topic	Description	Reference
Theme Config	Nav, sidebar, search, social links, footer	theme-config
Customization	CSS variables, slots, fonts, global components	theme-customization
Custom Theme	Building themes from scratch, theme interface	theme-custom

Advanced

Topic	Description	Reference
Internationalization	Multi-language sites, locale configuration	advanced-i18n
SSR Compatibility	Server-side rendering, ClientOnly, dynamic imports	advanced-ssr

Recipes

Topic	Description	Reference
Deployment	GitHub Pages, Netlify, Vercel, Cloudflare, Nginx	recipes-deploy

Weekly Installs

4.2K

Repository

antfu/skills

GitHub Stars

3.9K

First Seen

Jan 28, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

opencode3.4K

codex3.3K

gemini-cli3.3K

github-copilot3.1K

kimi-cli2.8K

amp2.8K