家

Skill

ウェブ開発

vitepress

antfu/skills

VitePress 静的サイトジェネレーターを使用して、ドキュメントサイトを構築し、テーマを設定し、Vue コンポーネントを含む Markdown を記述します。

...すべて拡張します

更新された時間 2026年9月7日

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

VitePressは、ViteとVue 3を基盤として構築された静的サイトジェネレーター（SSG）です。Markdownコンテンツを取り込み、テーマを適用して、高速なナビゲーションを実現するSPAとなる静的HTMLを生成します。ドキュメント、ブログ、マーケティングサイトにとって最適です。

主な特徴：

.mdファイルに基づくファイルルーティング
Markdown内でVueコンポーネントを直接使用可能
即時更新による高速なHMR（
ドキュメント向けに最適化されたデフォルトテーマ
内蔵検索機能（ローカルまたは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	フロントマター、コンテナ、テーブル、アンカー、インクルード	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

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