ノート・ドキュメント / Open Source

MkDocs
GitBook のオープンソース代替。 設定ファイルとMarkdownから文書サイトを作る。動作が軽い。
更新が1年以上ありません 最終コミットは2025/10/20です。完成して安定しているソフトは更新が少なくなりますが、脆弱性の修正が行われない可能性があります。導入前に、公式の最新の状況を確認してください。
MkDocsを30秒で
Markdownで書いた文書と、1つのYAMLの設定ファイルから、ドキュメントの静的なWebサイトを作るツールです。
向いている人
- プロジェクトのドキュメントを、Markdownで書いて公開したい人
- テーマやプラグインで、見た目や機能を広げたい人
向いていない人
- 画面上で、複数人がそのまま共同編集したい人(Markdownのファイルを書いて、サイトを生成する方式です)
- サイトの公開先(静的ファイルの置き場)を用意できない人
導入前に確認すること
- 開発の状況(掲載データでは、最終コミットが1年以上前で、直近12か月のリリースがありません)
- 使うテーマ・プラグインの提供元と更新状況(サードパーティの部品の質問は、それぞれのプロジェクトへ、とREADMEにあります)
- ライセンスはBSD-2-Clauseです
下の解説をもとに編集部がまとめました。検証状態は、解説の先頭に示しています。
- ライセンス
- BSD-2-Clause許容型
- 日本語
- 画面あり
- Docker
- 未確認
- 最終更新
- 1.1年前 1年以上更新がない
- GitHubのスター
- 2.3万同じカテゴリで12位/32件
掲載ツール全体の上位43%
直近32日間で+43 - OpenSSF Scorecard
- 4.1 / 10良好の目安は7.5以上
MkDocsが向いている使い方
- GitBookの代わりとして:設定ファイルとMarkdownだけで、軽い文書サイトを作りたい(GitBookの代替をすべて見る)
MkDocsを選ぶ前に(掲載データからの要約)
データから分かる強み
- OSI承認のライセンス(BSD-2-Clause)で、商用でも条件が少ない根拠:ライセンス表記
- 日本語の画面がある根拠:日本語化の確認
確認しておきたい点・向かない条件
- 最終コミットが384日前で、更新が止まっている可能性がある根拠:最終コミット 2025/10/20
- OpenSSF Scorecardが4.1と低め根拠:OpenSSF Scorecard(第三者の機械的な採点)
- 導入・運用
- 導入・運用の難易度:未評価難易度の評価は、診断データのある5つのSaaSの代替のみ。公式の導入手順を確認してください
- 保守・更新
- 最終コミット:384日前/直近12か月のリリース:0回
- 人気・成長
- 人気:ランキング対象391件中164位(Stars・Forks・Contributors)成長:361件中313位(直近7日・30日の実測)計算の根拠を見る →
- 公式の情報
- 公式サイト機能・料金・最新の情報GitHubのREADME導入手順・ドキュメントへの入口リリース一覧最新の版と変更点
掲載データ(GitHubの公開情報・OpenSSF Scorecard・OSSALTの記録)から自動で作っています。値が無い項目は、強みにも弱みにもせず「未確認」と示しています。導入前に、公式の最新の情報を確認してください。
MkDocsとは
公式資料確認済み公式資料と照合しました(2026/10/29)。
READMEとLICENSEの内容と、この解説を照合した(実機では動かしていない)
検証状態の意味
- 公式資料確認済み公式のドキュメント・README・公式サイトと照らして確認した(照合日と出典を記録)
- 実機検証済み実際に動かして確認した(確認した内容と日付を記録)
- 要再確認以前に確認したが、時間がたっている・内容が変わった可能性があり、再確認が必要
- 未検証照合の記録がない。導入前に公式の情報で確認する
MkDocs(エムケードックス)は、READMEで「プロジェクトのドキュメントのための、速く、シンプルな静的サイトジェネレーター」と説明されています。文書はMarkdownで書き、1つのYAMLの設定ファイルで設定します。テーマ、プラグイン、Markdownの拡張で広げられます。
できること(READMEの記載)
- Markdownのファイルから、静的なHTMLを作る。
- プラグインとMarkdownの拡張で、機能を足す。
- 組み込みのテーマ、サードパーティのテーマ、自作のテーマを使う。
- 静的ファイルを置ける場所なら、どこでも公開できる。
GitBookとの違い
GitBookは、画面上で編集できるドキュメントのサービスです。MkDocsは、Markdownのファイルからサイトを生成する道具で、公開先は自分で用意します(この比較は、READMEの説明からの整理です)。
注意点
- 開発の状況:OSSALTの掲載データでは、最終コミットは2025年10月20日、最新のリリースは2024年8月30日で、直近12か月のリリースはありません(2026年10月29日時点)。完成して安定しているソフトは更新が少なくなりますが、導入前に、公式のリポジトリとリリースノートで状況を確認してください。
- ライセンスはBSD-2-Clauseです。
- 公式のサポートは、MkDocsの中核の機能に限られます。サードパーティのテーマやプラグインの質問は、それぞれのプロジェクトへ、とREADMEにあります。
- 質問はGitHubのDiscussions、不具合や要望はIssueで受け付けています。
出典と確認の範囲
- 確認した資料:公式リポジトリのREADME・LICENSE(2026-10-29)。
- 確認していないこと:実際の導入、テーマ・プラグインの品質、GitBookとの機能の細かい比較。
解説の最終更新:2026/10/29。機能や提供条件は変わることがあるため、導入前に公式の情報をご確認ください。
健全度スコア
健全度
- スター × 0.2522,533
- フォーク × 0.52,659
- コントリビュータ × 0.5262
- ウォッチャー × 0.25223
- 更新の新しさ − 日数 × 0.51.1年前
スペック
- ライセンス
- BSD-2-Clause
- 主な言語
- Python
- 最終コミット
- 2025/10/201.1年前
- 公開開始
- 2014/01/12
- Docker対応
- 未確認
- 画面の日本語化
- 日本語の翻訳あり
- 日本語ドキュメント
- 未確認
ライセンス表記は「BSD-2-Clause」。最終コミット2025/10/20時点の情報です。
OSI承認のオープンソース分類:許容型(同じ種類のツール一覧)
「BSD-2-Clause」はOSI(Open Source Initiative)が承認したオープンソースライセンスです(許容型)。 出典:GitHub APIのライセンス判定(SPDX)。
MkDocsについてよくある質問
- MkDocsは日本語で使えますか?
- リポジトリに画面の日本語翻訳のファイルがあることを確認できています。翻訳されている範囲はツールによって異なるため、導入前に実際の画面で確かめてください。
- MkDocsはDockerで動かせますか?
- 当サイトでは、Dockerでの導入方法を確認できていません。別の方法で導入するツールや、Dockerの案内を別の場所に置いているツールもあるため、公式のドキュメントで確認してください。
- MkDocsは無料で使えますか? 業務で使ってもよいですか?
- ライセンスはBSD-2-Clause(許容型)です。制限の少ない「許容型」のライセンスで、社内の業務で使うことも、改変することも、広く認められています。配布するときは、著作権の表示などの条件を守る必要があります。自分のサーバーで動かす場合も、サーバー代と、アップデートやバックアップなどの運用の手間がかかります。また、一部の機能を有料版だけで提供しているツールもあります。
- MkDocsの開発は続いていますか?
- 最後の更新は384日前です。1年以上更新がないため、セキュリティの修正を受けられるかに注意が必要です。過去12か月のリリースは0回です。GitHubのスターは、直近32日間で43増えています。
- MkDocsのセキュリティの評価は?
- OpenSSF Scorecard(第三者による自動の採点)は10点満点中4.1点です(7.5点以上が良好の目安)。導入後は、セキュリティの更新を確実に適用してください。
- GitBookの代わりになる、MkDocs以外のツールは?
- 当サイトでは、Docusaurus、VitePressも掲載しています。下の比較表で、ライセンスや更新状況を見比べられます。
回答は掲載データ(GitHubの公開情報と、リポジトリの自動調査)から作成しています(2026/11/09時点)。
公式の説明(英語)
Project documentation with Markdown. Contribute to mkdocs/mkdocs development by creating an account on GitHub.
トピック
documentationmarkdownmkdocspythonstatic-site-generator
GitBook の代替候補を比較
| ツール | 主な代替対象 | スター | ライセンス | Docker対応 | 健全度 | セキュリティ |
|---|---|---|---|---|---|---|
| GitBook | 2.3万 | BSD-2-Clause | 未確認 | 7,105 | Scorecard4.1 | |
| GitBook | 6.7万 | MIT | 未確認 | 22,521 | Scorecard7.5 | |
| GitBook | 1.8万 | MIT | 未確認 | 6,231 | Scorecard4.5 |
あなたの条件(ライセンス・Docker・日本語など)で、GitBookの代替を並べ替える
乗り換えを検討するときは、機能の一致度より「移行コスト」と「運用コスト」で見るほうが失敗しにくいです。下の表でライセンスとDocker対応を確認してください。
MkDocs とほかの候補を比べる
同じカテゴリのツール
- AppFlowy (Notion の代替)
- Docusaurus (GitBook の代替)
- AFFiNE (Notion の代替)
- Memos (Flomo の代替)
- Joplin (Evernote の代替)
MkDocsの開発者の方へ:掲載バッジ
READMEなどに貼ると、このページへのリンクになります。貼るかどうかで、掲載の順番や評価が変わることはありません。
[](https://ossalt.jp/tools/mkdocs/)[](https://ossalt.jp/tools/mkdocs/)<a href="https://ossalt.jp/tools/mkdocs/"><img src="https://ossalt.jp/badges/listed-en.svg" alt="Listed on ossalt.jp" height="28"></a>