OSS探訪

VitePress — MarkdownとVueをViteで高速なdocumentation siteへ変換する

スコアの見方

OSS規模スコアはStars・Watchers・Forks・Contributorsを対数圧縮して重み付けした現在の規模指標(上限なし)です。発掘スコアは現在のOSS規模スコアから発掘時点のOSS規模スコアを引いた値、更新ペースは直近30日Commit数、成長モメンタムは直近の観測期間におけるOSS規模スコア差、OSS健全度は取得できた更新状況・Community Health・Releaseの0〜100評価です。

Stars
18,338
主要言語
TypeScript
ライセンス
MIT
リポジトリ最終更新
2026/09/13

概要

VitePressは、Markdownをsourceとして静的siteを生成するVue/ViteベースのSSGです。file-based routing、default theme、syntax highlight、Vue componentの埋め込みなどを使い、技術documentationやproject siteを構築できます。

特徴と向いている用途

公式資料に基づく紹介・実機未検証 · 内容確認日:

Markdown fileをそのままpage routeへ変換する

project root内のMarkdown fileをfile-based routingでHTML pageへ変換し、sidebarやnavigationを含むdocumentation siteを構築できます。

出典:[3][2]

Vue componentとViteの開発環境をdocumentationへ持ち込む

Markdown内でVue componentやAPIを利用でき、Viteのdev serverとhot updateを使ってsiteを編集できます。

出典:[3][2]

OSS・library・社内技術documentationの静的siteに

Markdown中心で書きつつ、必要な箇所だけinteractiveなVue componentを追加したいdocumentationやproject siteに向きます。

出典:[2]

現在のmainは2.0 alphaで、Node.js 22+・ESM-only

現行mainとcurrent docsは2.0 alpha系列を対象にvitepress@nextを使います。既存1.x siteではversionごとのguideを分け、pluginやtheme互換性を確認してください。

出典:[4][3]

参考にした公式資料

  1. [1]vuejs/vitepress repository(2026-09-21)
  2. [2]VitePress README(2026-09-21)
  3. [3]VitePress Getting Started(2026-09-21)
  4. [4]vitepress package(2026-09-21)
  5. [5]VitePress MIT license(2026-09-21)
編集部からの補足

現在のmainは`2.0.0-alpha.20`で、公式Getting Startedも`vitepress@next`を指定しています。Node.js 22以上かつESM-onlyが前提です。安定版1.xの既存siteを運用している場合は、2.0 alphaのguideをそのまま適用せず、導入versionに合うdocumentationを確認してください。

3ステップで試す

  1. 1

    VitePress 2 alphaを追加

    current main/docsと同じ2.0 alpha系列を試すため、official guideどおりnext dist-tagを追加します。

    npm add -D vitepress@next
  2. 2

    setup wizardを実行

    docs directory、theme、npm script等を対話形式で生成します。

    npx vitepress init
  3. 3

    documentation siteを起動

    wizardが追加したscriptでVite-powered dev serverを起動し、Markdown pageを確認します。

    npm run docs:dev
公式READMEで確認

成長

成長の推移 · 直近30日

18,338 Stars

推移データを蓄積中です。

開発アクティビティ

直近90日・週次

Commit(直近30日)
46
Open PR
87

開発アクティビティを蓄積中です。

Built with

カテゴリとタグ

GitHubデータ

GitHubのデータGitHubの詳細データを見る

GitHub Topics

  • vue
  • vite
  • docs-generator
  • ssg
  • hacktoberfest
  • markdown
Stars
18,338
Forks
2,733
Watchers
85
Open Issues
230
Contributors
412
主要言語
TypeScript
ライセンス
MIT
リポジトリ最終更新
2026/09/13

このOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。

情報の誤りを報告

掲載内容に誤りや古い情報があればお知らせください。