> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/ja-gitbook-documentation/getting-started/quickstart.md). # クイックスタート このクイックスタートガイドでは、GitBook でのセットアップ方法と、最初のドキュメントサイトを数分で公開する方法を説明します。 このガイドの最後には、公開中のドキュメントサイトができ上がり、拡張やカスタマイズの準備が整います。 {% stepper %} {% step %} **始め方** 必要なもの [アカウントを作成する](https://app.gitbook.com/join) 必要があります。そうして初めて、最初のドキュメントサイトを使い始められます。 アカウントを作成すると、編集やカスタマイズの準備ができた新しいドキュメントサイトが自動的に表示されます。公開する前に、画面上のオプションからサイトにコンテンツを追加する方法を選択してください。 {% hint style="success" %} コンテンツはまだ公開されていません。公開する前に、ドキュメントサイトを編集、カスタマイズ、プレビューできます。 **公開** を押すと、すぐに公開されます。 :arrow-down: [このページの「公開」セクションへ移動する](#publish-your-documentation) {% endhint %} {% endstep %} {% step %} **コンテンツを編集する** GitBook でコンテンツを編集・更新する方法は 2 つあります。ビジュアルエディターを使う方法と、docs-as-code ワークフローに従う方法です。 **どちらか一方を選んでも、両方を組み合わせてもかまいません**. どのワークフローを選んでも、コンテンツは **ブランチベースの編集フロー**を使って編集します。詳しくは [概念ページ](/docs/documentation/ja-gitbook-documentation/rissu/concepts.md).
ビジュアルエディターを使う GitBook の WYSIWYG（見たままがそのまま反映される）エディターを使うと、コンテンツを視覚的に編集したり、コンテンツブロックをドラッグして並べ替えたり、作業しながら表示の見え方を確認できます。 このビジュアル編集ワークフローは、コードエディターを使いたくないユーザーや、Notion や Google Docs のようなツールを使った経験があるユーザーに最適です。 **1. 変更リクエストでドキュメントを編集する** まず、サイドバーでドキュメントサイトを見つけ、その下にある項目をクリックします。すると、コンテンツが保存されているスペースに移動します。 クリック **編集** を右上でクリックします。すると変更リクエストが開き、スペースのコンテンツを編集できます。 クリック **新規追加…** を左側の目次で選択してページを追加し、タイトルを付けます。
A screenshot of the Editor in the GitBook app, zoomed in to show the menu that lets you add new pages, groups, links and more to a GitBook space.
**2. 変更内容をプレビューする** Web アプリの上部には、 **エディター**, **変更** と **プレビュー**のタブがあります。これらでコンテンツの異なる表示に切り替えられます。 クリック **プレビュー** デスクトップとモバイルの両方で、変更リクエスト内のすべての変更が適用された状態のドキュメントサイトがどう表示されるかを、ライブプレビューで確認できます。
A screenshot of the GitBook app with the Preview tab open, showing a docs site being previewed on a mobile-size display
**3. 変更をマージする** 変更に満足したら、右上隅の **マージ** ボタンをクリックします。 これにより、変更リクエスト内のすべての編集内容がコンテンツのメイン版に反映されます。コンテンツが公開中のドキュメントサイトの一部である場合、サイトはただちに更新されます。
コードベースの編集 GitHub または GitLab のリポジトリとドキュメントを同期すると、コードベースの編集が有効になります。同期後は、既存の開発環境でドキュメントを編集できます。 このワークフローは、ツールを切り替えたくない技術ユーザーや、他のコードと一緒にドキュメントを管理したいユーザーに最適です。 **1. Git Sync を設定する** サイト作成時にまだ Git Sync を設定していない場合は、まずサイドバーでドキュメントサイトを見つけ、その下にあるコンテンツ名をクリックします。すると、コンテンツが保存されているスペースに移動します。 右上の **Git Sync を設定** ボタンをクリックし、手順に従ってスペースを選択した Git リポジトリに同期します。 詳しくは [Git Sync ページ](/docs/documentation/ja-gitbook-documentation/getting-started/git-sync.md) をご覧ください。 **2. 開発環境からドキュメントを編集する** スペースを Git リポジトリに同期すると、開発環境内のそのリポジトリからドキュメントのコンテンツを更新できます。 リポジトリを開き、プルリクエストを作成して、必要な変更を加えます。 {% hint style="info" %} #### Markdown 編集 GitBook は [Markdown 編集](/docs/documentation/ja-gitbook-documentation/creating-content/formatting/markdown.md)をサポートしているため、一般的な構文を使ってコンテンツを作成・整形できます。 GitBook の標準ブロックはすべて、Markdown 構文で記述・整形できます。 {% endhint %} **3. 変更内容をプレビューする** 変更内容を [プレビュー](/docs/documentation/ja-gitbook-documentation/getting-started/git-sync/github-pull-request-preview.md) して、GitHub または GitLab のプルリクエストから公開中のドキュメントサイトで確認できます。 プルリクエストでは、固有のプレビュー URL を含むステータスが表示されます。そのステータスの **詳細** をクリックするとプレビュー URL が開き、プルリクエストがマージされてサイトが更新されたときの見え方を確認できます。 **4. 変更をマージする** これで準備完了です。プルリクエストをマージすると、GitBook アプリと、公開中であればドキュメントサイトの両方でコンテンツが更新されます。 GitBook アプリでは、各コミットとマージ済みのプルリクエストが、バージョン履歴内の更新としてスペースに同期されます。
A screenshot of the GitBook app showing the version history side panel open. In the side panel the highlighted entry shows a pull request from GitHub that was merged as part of the history, with a link to view the pull request on GitHub.
{% endstep %} {% step %} **ドキュメントをカスタマイズする**
サイトのナビゲーションを整理する API リファレンス、ヘルプセンター、変更履歴など、サイトにコンテンツをいつでも追加できます。コンテンツを追加したら、ユーザーが探しているものを見つけやすいように、サイトのナビゲーションバーを整理できます。 詳しくは [概念ページ](/docs/documentation/ja-gitbook-documentation/rissu/concepts.md) をご覧ください。サイトのナビゲーションについて 詳しくは [サイト構成ページ](/docs/documentation/ja-gitbook-documentation/docs-site/site-structure.md) をご覧ください。サイトへのコンテンツ追加について
A screenshot of a published docs site hosted on GitBook. The top of the site has a navigation bar, and the cursor is hovering over a drop-down in that bar, with a submenu open below it showing links to more pages
ドキュメントサイトの見た目をカスタマイズする ドキュメントサイトは標準設定でも見栄えよく表示されますが、公開サイトの見た目や印象を変える多くの設定もカスタマイズできます。 サイトの [ロゴ、色、フォント](/docs/documentation/ja-gitbook-documentation/docs-site/customization/icons-colors-and-themes.md)をカスタマイズしたり、 [サイトセクション](/docs/documentation/ja-gitbook-documentation/docs-site/site-structure/site-sections.md) と [バリアント](/docs/documentation/ja-gitbook-documentation/docs-site/site-structure/variants.md)を使ってサイトのナビゲーションバーに追加したり、 [サイトの公開設定](/docs/documentation/ja-gitbook-documentation/docs-site/site-settings.md#audience) などを更新できます。
An illustration showing five docs sites hosted in GitBook, each with distinct visual customizations
{% endstep %} {% step %} **ドキュメントを公開する**
ドキュメントを公開する サイトはいつでもクリックひとつで公開できます。 サイドバーでサイト名をクリックしてサイトのダッシュボードを開きます。次に、 **公開** を右上隅でクリックして公開します。 サイトが公開されると、ダッシュボードは公開サイトへのリンクを表示するように更新されます。
A screenshot of the GitBook app showing a dashboard for a docs site. The dashboard shows the public URL, site status, site content, some top-level analytics for the site, and other options in tabs along the top of the screen.
{% hint style="success" %} 公開についてさらに詳しく知りたいですか？ [GitBook でコンテンツを作成・公開するための完全ガイド](/docs/guides/editing-and-publishing-documentation/complete-guide-to-publishing-docs-gitbook.md). {% endhint %}
カスタムドメインを追加する デフォルトでは、サイトは次の形式の一意の URL で公開されます。 ``` https://[organization-name].gitbook.io/[site-title] ``` これは一部のチームには適していますが、多くのチームは URL を次のように変更することを選びます。 [カスタムドメイン](/docs/documentation/ja-gitbook-documentation/docs-site/custom-domain.md) または [カスタムサブディレクトリ](/docs/documentation/ja-gitbook-documentation/docs-site/custom-domain/setting-a-custom-subdirectory.md). これを行うには、サイドバーでサイト名をクリックしてサイトのダッシュボードを開き、次に **設定** タブを開いて **ドメインと URL**.
A screenshot of the GitBook app showing the menu that guides you through the process of setting up a custom domain for your docs site.
を選びます。画面上のボタンで希望のオプションを選択し、ドメインプロバイダーで DNS 設定を構成する手順に従ってください。 {% hint style="info" %} DNS の変更が反映されるまで最大 48 時間かかる場合があります。ただし、通常はもっと早く伝播します。 {% endhint %}
{% endstep %} {% endstepper %} ### 次のステップ
カバー画像カバー画像（ダーク）カバー画像（ダーク）カバー画像（ダーク）カバー画像（ダーク）カバー画像（ダーク）
チームを招待して共同作業する組織にチームメンバーを追加し、権限を設定する/files/b47c174e6fd51629c63b994d670dc1434cbe1ed9/pages/e7f961e40a9e3175310b21716bce866be03225d8/files/ec74e12270dc907ed3561bf1f6dd258230cf2295/files/ec74e12270dc907ed3561bf1f6dd258230cf2295
サイトの公開範囲を変更する共有リンクと認証済みアクセスで、誰がコンテンツを閲覧できるかを制御する/files/fd2ba96fe1ee9324aed2a14f880a303eb4957ed3/pages/37f11f55f4220a1d169cd8ed543486c55684f5bf#publish-a-docs-site/files/13f092853675ff932305fdefdd5c6ffdb1d102ba/files/13f092853675ff932305fdefdd5c6ffdb1d102ba/files/13f092853675ff932305fdefdd5c6ffdb1d102ba
自動翻訳を追加するワンクリックで翻訳を作成し、自動更新する/files/09d1042fd33c37f17e235047a85ad7b8c7671b75/pages/7f67aba647e0d7c72577043b29a77711dcc60f8d/files/529f1497c699578448c29dcd23ba17f75cdafea2/files/529f1497c699578448c29dcd23ba17f75cdafea2
連携をインストールするスタックと統合し、強力な連携機能で機能を拡張する/files/255138c5edaa71173412fd5bd600264b2998a1b5/pages/71043d094c98fde9931838b59a16dca6fe6f0bfa/files/75c70a575719de716328beb648ac2ceabc6a6004/files/75c70a575719de716328beb648ac2ceabc6a6004
API リファレンスを追加するAPI 仕様から自動更新される対話型 API リファレンスドキュメントを作成する/files/89d97c5c9558d8716806350dfdef57596e63b0d4/pages/8f82fb55bc9bc941e0e9f34aa206234409488ef3/files/2684564247529c54f4fac5dc8310b7e30f43fafa
ドキュメント分析を追跡する組み込みの分析情報を使って成果を測定し、ユーザー行動を理解する/files/a86f47574b4d261c7a3b65a784a141e9316ca057/pages/fde014aaa6aebaaa1a909804747fce75f331d76d/files/51dfcc4c75ac91dd75332d7571efdf5fe387576a
### よくある質問
GitBook とは何ですか？ GitBook は、チームがブランド化されたドキュメントをウェブサイトとして作成、レビュー、公開できる、共同作業型の AI ネイティブなドキュメントプラットフォームです。GitBook でホストされるドキュメントサイトは、組み込みの AI アシスタントを提供でき、MCP 経由で他の AI ツールとも接続できます。 高度なビジュアルエディターで Markdown を使ってコンテンツを編集したり、Git リポジトリとドキュメントを同期して docs as code のワークフローを実現したり、あるいはその両方を組み合わせたりできます。チームが GitBook をどう使う場合でも、完全なバージョン履歴を備えた Git 風のブランチワークフローを使うため、主なコンテンツを保護しつつ、チーム全体での共同作業とフィードバックを促進できます。
GitBook でドキュメントを公開するにはどうすればよいですか？ GitBook での公開は、コンテンツが公開可能な状態になったらシンプルに行えます。 1. 新しいドキュメントサイトを作成する（または既存のものを開く）し、公開したいコンテンツを選びます。 2. サイトの対象読者を選びます。 **公開** 設定で全員に公開することも、 **共有リンク** または **認証済みアクセス**. 3. で対象を制限することもできます。（任意）組み込みのオプションを使って、ブランディング、ドメイン、テーマをカスタマイズします。 4. クリック **公開**。おめでとうございます — ドキュメントが公開されました！ 後からサイトセクションやバリアントとしてスペースを追加できます。 詳しくは [クイックスタートガイド](#getting-started) 、または [GitBook でドキュメントを作成・公開するための完全ガイド](/docs/guides/editing-and-publishing-documentation/complete-guide-to-publishing-docs-gitbook.md).
GitBook はオープンソースですか？ GitBook 自体はオープンソースではありません。ただし、ドキュメントサイト上でドキュメントをホスト・表示するために使われる GitBook の公開ドキュメントプラットフォームはオープンソースです。 [リポジトリを訪問して](https://github.com/GitbookIO/gitbook) コードを確認し、変更を提出してレビューを依頼できます。 GitBook 自体はオープンソースではありませんが、 **オープンソースプロジェクトは GitBook で無料でドキュメントを公開できます**。チームは [コミュニティプラン](/docs/documentation/ja-gitbook-documentation/akaunto/plans/community.md) に登録し、 [スポンサー付きサイトプラン](/docs/documentation/ja-gitbook-documentation/akaunto/plans/community/sponsored-site-plan.md)を使ってコンテンツを公開できます。これらはいずれも条件を満たすチームには無料です。
GitBook でサイトとスペースの違いは何ですか？ GitBook では、 **ドキュメントサイト** がドキュメント全体のハブであり、対象読者がアクセスできるすべてのコンテンツをホストし、テーマやドメインなどのカスタマイズ可能なオプションを備えています。 各サイトには 1 つ以上の **スペース**が含まれており、これらはサイト内の個別セクションとして機能し、関連コンテンツを整理して、より高いモジュール性と管理のしやすさを実現します。スペースを使うと、特定のトピックに絞って共同作業でき、複数のスペースを 1 つのサイトにまとめて構造を作ったり、翻訳（ローカライズされたドキュメント）や複数製品のサポートなどのオプションを有効にしたりできます。
GitBook のビジュアルエディターと Git Sync の違いは何ですか？ GitBook では、ドキュメントを編集する主な方法が 2 つあります。ビジュアルエディターと Git Sync です。 **ビジュアルエディター** は、Markdown サポートを含む従来型のユーザーインターフェースを使って、GitBook 内で直接コンテンツを作成・変更できる高度なブロックベースのエディターです。コードに直接触れず、より直感的で実践的な編集体験を好む人に最適です。 **Git Sync** は、ドキュメントのワークフローを Git リポジトリと統合し、「docs as code」アプローチを可能にします。このオプションは、慣れ親しんだ Git コマンドとワークフローを使って、コードベースと一緒にドキュメントを管理したい開発者やチームに最適です。 チームはこれらのワークフローのどちらか一方を選ぶことも、両方を組み合わせて使うこともできます。どの方法を選んでも、編集は完全なバージョン履歴とコンテンツレビューのプロセスを備えた、一貫した Git 風のブランチワークフローに従います。これにより、ドキュメント全体での共同作業と品質が高まるだけでなく、主要コンテンツを誤編集からも保護できます。
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/getting-started/quickstart.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.