---
title: クイックスタート
description: >-
  Blume をインストールし、新しいプロジェクトを作成して、数分で最初のドキュメントページを公開しましょう。その後は自分のペースで本格的なサイトへと育てていけます。
sidebar:
  label: クイックスタート
  order: 1
---

空のフォルダから、いくつかのコマンドだけで動作するドキュメントサイトまで到達できます。Blume に必要なのは **Node.js 22.12 以降**と、`.md` または `.mdx` ファイルを 1 つ以上含む `docs/` フォルダだけです。それ以外に用意するものはありません。

## インストールと実行 [#install-and-run]

1. **Blume をインストールする**

    新規または既存のプロジェクトにパッケージを追加します。

    ```package-install
    npm i blume
    ```

2. **プロジェクトを作成する**

    `blume init` はいくつかの質問をします — プロジェクトを作成する場所、ドキュメントサイトの名前、使用するテンプレート、コンテンツの配置場所 — そのうえで最小限の構成、つまりコンテンツフォルダと設定ファイルを生成します。プロンプトをスキップしてデフォルト値を使うには `--yes` を渡してください。

    ```bash
    blume init
    ```

    ```txt
    docs/
      index.mdx
    blume.config.ts
    ```

3. **開発サーバーを起動する**

    Blume がランタイムを生成し、ホットリロード付きでドキュメントを配信します。

    ```bash
    blume dev
    ```

4. **本番向けにビルドする**

    静的 HTML が `dist/` に出力され、それを対象としたローカル検索インデックスが構築されます。

    ```bash
    blume build
    ```

:::tip
Blume はあらゆるパッケージマネージャーで動作し、Astro や Tailwind を自分でセットアップする必要は一切ありません。
:::

## 最初のページを書く [#write-your-first-page]

すべてのページは、少しのフロントマターを添えた Markdown または MDX です。`title` と `description` は自動的にページの見出しとイントロとして表示されます。次の内容を `docs/index.mdx` に貼り付けてみましょう。

```mdx docs/index.mdx lineNumbers
---
title: Introduction
description: Welcome to my docs.
---

Welcome! Use **Markdown** and built-in components — no imports required:

:::note
Blume ships callouts, cards, tabs, steps, and more.
:::
```

保存すれば、開発サーバーが即座にリロードします。ナビゲーション、検索、ページメタデータは、ファイルを追加するたびにそれらから推論されます。書き続けるだけで、サイトがついてきます。

## 次のステップ [#next-steps]

**[設定](/docs/configuration)**

タイトル、テーマ、検索、デプロイを調整します。

**[コンポーネント](/docs/content/components)**

組み込みのコンポーネントライブラリを見てみましょう。

**[発見されやすさ](/docs/discoverability)**

`llms.txt`、ソーシャルカード、MCP サーバーを提供します。

**[デプロイ](/docs/deployment)**

任意の静的ホスティングで公開しましょう。