# MkDocs GitBookの代わりになるオープンソース。設定ファイルとMarkdownから文書サイトを作る。動作が軽い。 - ossalt.jp のページ: https://ossalt.jp/tools/mkdocs/ - 公式サイト: https://www.mkdocs.org - GitHub: https://github.com/mkdocs/mkdocs - 代わりになるSaaS: GitBook - カテゴリ: ノート・ドキュメント - ライセンス: BSD-2-Clause（許容型） - 画面の日本語翻訳: あり - 日本語のドキュメント: 未確認 - Dockerでの導入: 未確認 - GitHubのスター: 22,533（直近32日間で+43） - 最終コミット: 2025-10-20 - OpenSSF Scorecard: 4.1 / 10 ## MkDocsとは 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との機能の細かい比較。 ## よくある質問 **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も掲載しています。下の比較表で、ライセンスや更新状況を見比べられます。 --- データ: ossalt.jp（2026-11-08時点。GitHubの公開データとリポジトリの自動調査による）。「未確認」は「非対応」という意味ではありません。導入前に公式の情報を確認してください。