ノート・ドキュメント / 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が向いている使い方

MkDocsを選ぶ前に(掲載データからの要約)

取得日:2026/11/09

データから分かる強み

  • 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の内容と、この解説を照合した(実機では動かしていない)

出典:github.com github.com

検証状態の意味
  • 公式資料確認済み公式のドキュメント・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。機能や提供条件は変わることがあるため、導入前に公式の情報をご確認ください。

健全度スコア

健全度

GitHub 公開情報
7,105
  • スター × 0.2522,533
  • フォーク × 0.52,659
  • コントリビュータ × 0.5262
  • ウォッチャー × 0.25223
  • 更新の新しさ − 日数 × 0.51.1年前
健全度スコアの説明

スター・フォーク・コントリビュータ・ウォッチャー・更新の新しさの5項目から算出した、プロジェクトの勢いの目安です。上から5つの目盛りが、その5項目を表します。 スターなどの数値はGitHubの公開情報、更新日は最終コミット日をもとにしています。減点は最終コミットから90日で頭打ち(最大 −45点)になります。数値が大きいほど活発ですが、規模の大きいプロジェクトほど有利になる指標です。

スコアの読み方と目安は選び方のページに、スターやフォークなど各数字の意味はGitHubの見方にまとめています。

スペック

ライセンス
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対応健全度セキュリティ
MkDocsGitBook2.3万BSD-2-Clause未確認7,105Scorecard4.1
DocusaurusGitBook6.7万MIT未確認22,521Scorecard7.5
VitePressGitBook1.8万MIT未確認6,231Scorecard4.5

あなたの条件(ライセンス・Docker・日本語など)で、GitBookの代替を並べ替える

乗り換えを検討するときは、機能の一致度より「移行コスト」と「運用コスト」で見るほうが失敗しにくいです。下の表でライセンスとDocker対応を確認してください。

MkDocs とほかの候補を比べる

同じカテゴリのツール

MkDocsの開発者の方へ:掲載バッジ

READMEなどに貼ると、このページへのリンクになります。貼るかどうかで、掲載の順番や評価が変わることはありません。

Listed on ossalt.jpossalt.jp に掲載

Markdown(英語)
[![Listed on ossalt.jp](https://ossalt.jp/badges/listed-en.svg)](https://ossalt.jp/tools/mkdocs/)
Markdown(日本語)
[![ossalt.jp に掲載](https://ossalt.jp/badges/listed-ja.svg)](https://ossalt.jp/tools/mkdocs/)
HTML(英語)
<a href="https://ossalt.jp/tools/mkdocs/"><img src="https://ossalt.jp/badges/listed-en.svg" alt="Listed on ossalt.jp" height="28"></a>

バッジについて