GitHub のすべてのリポジトリに、Wiki と呼ばれるドキュメントをホストするセクションが備わっています。 リポジトリのウィキは、プロジェクトの利用方法、設計方法、中核的な原理など、プロジェクトに関する長いコンテンツを共有するために利用できます。 README ファイルは、プロジェクトができることを手短に述べますが、ウィキを使えば追加のドキュメンテーションを提供できます。 詳しくは、「READMEについて」をご覧ください。
Wiki を使用すると、GitHub の他の場所と同じようにコンテンツを作成できます。 詳しくは、「GitHub での記述と書式設定の開始」をご覧ください。 私たちは、さまざまなフォーマットを HTML に変更するのに私たちのオープンソース マークアップ ライブラリを使っているので、Markdown あるいはその他のサポートされているフォーマットで書くことができます。
Markdown を使用して、レンダリングされた数式、ダイアグラム、マップ、3D モデルを Wiki に追加できます。 レンダリングされた数式の作成の詳細については、「数式の記述」を参照してください。 ダイアグラム、マップ、3D モデルの作成の詳細については、「ダイアグラムの作成」を参照してください。
パブリック リポジトリに Wiki を作成すると、Wiki は、一般公開されます。 プライベート リポジトリに Wiki を作成した場合、そのリポジトリにアクセスできるユーザーのみが Wiki にアクセスできます。 詳しくは、「リポジトリの可視性を設定する」をご覧ください。
ウィキは、GitHub 上で直接編集することも、ウィキのファイルをローカルで編集することもできます。 デフォルトでは、リポジトリへの書き込みアクセス権を持つユーザのみが Wiki に変更を加えることができますが、GitHub.com のすべてのユーザがパブリック リポジトリの Wiki に貢献できるようにすることも可能です。 詳しくは、「Wiki へのアクセス権限の変更」をご覧ください。
Note
検索エンジンを使うと、パブリック編集を防ぐために構成した star が 500 個以上付いている Wiki のみにインデックスが作成されます。 詳しくは、「Wiki へのアクセス権限の変更」をご覧ください。
コンテンツにインデックスを作成するために検索エンジンが必要な場合は、パブリック リポジトリで GitHub Pages を使うことができます。 詳しくは、「GitHub Pages」をご覧ください。
Note
パフォーマンス上の理由から、Wiki にはファイルの種類に関係なく、ファイル数合計 5,000 のソフト制限があります。 この制限を超えると、一部のページにユーザーがアクセスできなくなる場合があります。 より大きな Wiki が必要な場合は、GitHub Pages を使用することをお勧めします。 詳しくは、「GitHub Pages」をご覧ください。