Дом

Skill

Веб-разработка

vitepress

antfu/skills

Создавайте сайты с документацией, настраивайте темы и пишите Markdown с компонентами Vue, используя статический генератор сайтов VitePress.

...Расширить все

Обновлено время 7 сентября 2026 г.

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

VitePress — это генератор статических сайтов (SSG), построенный на базе Vite и Vue 3. Он обрабатывает контент в формате Markdown, применяет тему и генерирует статические HTML-файлы, которые формируют одностраничное приложение (SPA) для быстрой навигации. Идеально подходит для документации, блогов и маркетинговых сайтов.

Основные характеристики:

Маршрутизация на основе файлов с расширением .md
Компоненты Vue работают непосредственно в Markdown
Быстрая горячая замена модулей (HMR) с мгновенным обновлением (
Тема по умолчанию, оптимизированная для документации
Встроенный поиск (локальный или через Algolia)

Перед началом работы с проектами VitePress:

Проверьте файл .vitepress/config.ts для настройки сайта
Изучите директорию .vitepress/theme/ для расширений пользовательской темы
Директория public/ содержит статические ресурсы, которые отдаются как есть

Навык основан на версии VitePress 1.x, сгенерированной 28 января 2026 года.

Основные возможности

Тема	Описание	Ссылка
Конфигурация	Настройка файла конфигурации, defineConfig, метаданные сайта	core-config
CLI	Интерфейс командной строки: dev, build, preview, init	core-cli
Маршрутизация	Файловая маршрутизация, исходная директория, переопределение путей	core-routing
Markdown	Frontmatter, контейнеры, таблицы, якоря, включение файлов	core-markdown

Функции

Код и контент

Тема	Описание	Ссылка
Блоки кода	Подсветка синтаксиса, выделение строк, сравнение изменений (diffs), фокус	features-code-blocks
Vue в Markdown	Компоненты, 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

Посмотреть на 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) |