SKILL.md
readonly只读
name
vitepress
description
基于 Vite 和 Vue 的 VitePress 静态站点生成器。用于构建文档站点、配置主题或编写包含 Vue 组件的 Markdown。
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。
核心
| 主题 | 描述 | 参考 |
|---|---|---|
| 配置 | 配置文件设置、defineConfig、站点元数据 | core-config |
| CLI | 命令行界面：dev、build、preview、init | core-cli |
| 路由 | 基于文件的路由、源目录、重写 | core-routing |
| Markdown | Frontmatter、容器、表格、锚点、包含 | core-markdown |
功能
代码与内容
| 主题 | 描述 | 参考 |
|---|---|---|
| 代码块 | 语法高亮、行高亮、差异、聚焦 | 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 |
