Hogar

Skill

Desarrollo web

vitepress

antfu/skills

Construye sitios de documentación, configura temas y escribe Markdown con componentes de Vue utilizando el generador de sitios estáticos VitePress.

...Expandir todo

Tiempo actualizado 7 de septiembre de 2026

# documentation # markdown # vue # ssg # static site generator # vitepress

VitePress es un Generador de Sitios Estáticos (SSG) construido sobre Vite y Vue 3. Toma contenido en Markdown, aplica un tema y genera HTML estático que se convierte en una SPA para una navegación rápida. Ideal para documentación, blogs y sitios de marketing.

Características principales:

Enrutamiento basado en archivos con archivos .md
Los componentes de Vue funcionan directamente en Markdown
HMR rápido con actualizaciones instantáneas (
Tema predeterminado optimizado para documentación
Búsqueda integrada (local o Algolia)

Antes de trabajar con proyectos de VitePress:

Comprueba .vitepress/config.ts para la configuración del sitio
Examina .vitepress/theme/ para extensiones de temas personalizados
El directorio public/ contiene activos estáticos que se sirven tal cual

La habilidad se basa en VitePress 1.x, generada el 2026-01-28.

Core

Tema	Descripción	Referencia
Configuración	Configuración del archivo de configuración, defineConfig, metadatos del sitio	core-config
CLI	Interfaz de línea de comandos: dev, build, preview, init	core-cli
Enrutamiento	Enrutamiento basado en archivos, directorio de origen, reescrituras	core-routing
Markdown	Frontmatter, contenedores, tablas, anclas, inclusiones	core-markdown

Features

Código y contenido

Tema	Descripción	Referencia
Bloques de código	Resaltado de sintaxis, resaltado de líneas, diferencias, enfoque	features-code-blocks
Vue en Markdown	Componentes, script setup, directivas, plantillas	features-vue
Carga de datos	Cargadores de datos en tiempo de compilación, createContentLoader	features-data-loading
Rutas dinámicas	Generar páginas a partir de datos, archivos del cargador de rutas	features-dynamic-routes

Theme

Tema	Descripción	Referencia
Configuración del tema	Nav, barra lateral, búsqueda, enlaces sociales, pie de página	theme-config
Personalización	Variables CSS, ranuras, fuentes, componentes globales	theme-customization
Tema personalizado	Construcción de temas desde cero, interfaz del tema	theme-custom

Advanced

Tema	Descripción	Referencia
Internacionalización	Sitios multilingües, configuración de localización	advanced-i18n
Compatibilidad con SSR	Renderizado en el lado del servidor, ClientOnly, importaciones dinámicas	advanced-ssr

Recipes

Tema	Descripción	Referencia
Despliegue	GitHub Pages, Netlify, Vercel, Cloudflare, Nginx	recipes-deploy

Ver en GitHub

---
name: vitepress
description: Build documentation sites, configure themes, and write Markdown with Vue components using the VitePress static site generator.
---

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](references/core-config.md) |
| CLI | Command-line interface: dev, build, preview, init | [core-cli](references/core-cli.md) |
| Routing | File-based routing, source directory, rewrites | [core-routing](references/core-routing.md) |
| Markdown | Frontmatter, containers, tables, anchors, includes | [core-markdown](references/core-markdown.md) |

## Features

### Code & Content

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

## Theme

| Topic | Description | Reference |
|-------|-------------|-----------|
| Theme Config | Nav, sidebar, search, social links, footer | [theme-config](references/theme-config.md) |
| Customization | CSS variables, slots, fonts, global components | [theme-customization](references/theme-customization.md) |
| Custom Theme | Building themes from scratch, theme interface | [theme-custom](references/theme-custom.md) |

## Advanced

| Topic | Description | Reference |
|-------|-------------|-----------|
| Internationalization | Multi-language sites, locale configuration | [advanced-i18n](references/advanced-i18n.md) |
| SSR Compatibility | Server-side rendering, ClientOnly, dynamic imports | [advanced-ssr](references/advanced-ssr.md) |

## Recipes

| Topic | Description | Reference |
|-------|-------------|-----------|
| Deployment | GitHub Pages, Netlify, Vercel, Cloudflare, Nginx | [recipes-deploy](references/recipes-deploy.md) |