Lar

Skill

Desenvolvimento Web

vitepress

antfu/skills

Construa sites de documentação, configure temas e escreva Markdown com componentes Vue usando o gerador de sites estáticos VitePress.

...Expandir tudo

Tempo atualizado 7 de Setembro de 2026

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

O VitePress é um Gerador de Sites Estáticos (SSG) construído sobre o Vite e o Vue 3. Ele pega conteúdo em Markdown, aplica um tema e gera HTML estático que se torna uma SPA (Single Page Application) para navegação rápida. Ideal para documentação, blogs e sites de marketing.

Características Principais:

Roteamento baseado em arquivos com arquivos .md
Componentes Vue funcionam diretamente no Markdown
HMR (Hot Module Replacement) rápido com atualizações instantâneas (
Tema padrão otimizado para documentação
Busca integrada (local ou Algolia)

Antes de trabalhar com projetos VitePress:

Verifique .vitepress/config.ts para a configuração do site
Consulte .vitepress/theme/ para extensões de tema personalizado
O diretório public/ contém ativos estáticos servidos como estão

A habilidade baseia-se no VitePress 1.x, gerado em 2026-01-28.

Core

Tópico	Descrição	Referência
Configuração	Configuração do arquivo, defineConfig, metadados do site	core-config
CLI	Interface de linha de comando: dev, build, preview, init	core-cli
Roteamento	Roteamento baseado em arquivos, diretório de origem, reescritas	core-routing
Markdown	Frontmatter, contêineres, tabelas, âncoras, inclusões	core-markdown

Features

Código e Conteúdo

Tópico	Descrição	Referência
Blocos de Código	Destaque de sintaxe, destaque de linhas, diffs, foco	features-code-blocks
Vue no Markdown	Componentes, script setup, diretivas, modelagem	features-vue
Carregamento de Dados	Carregadores de dados em tempo de compilação, createContentLoader	features-data-loading
Roteamento Dinâmico	Gerar páginas a partir de dados, arquivos do carregador de caminhos	features-dynamic-routes

Theme

Tópico	Descrição	Referência
Configuração do Tema	Nav, barra lateral, busca, links sociais, rodapé	theme-config
Personalização	Variáveis CSS, slots, fontes, componentes globais	theme-customization
Tema Personalizado	Criação de temas do zero, interface do tema	theme-custom

Advanced

Tópico	Descrição	Referência
Internacionalização	Sites multilíngues, configuração de localidade	advanced-i18n
Compatibilidade com SSR	Renderização no lado do servidor, ClientOnly, importações dinâmicas	advanced-ssr

Recipes

Tópico	Descrição	Referência
Implantação	GitHub Pages, Netlify, Vercel, Cloudflare, Nginx	recipes-deploy

Ver no 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) |