MkDocsとは?静的サイトジェネレータについて解説

MkDocsとは

MkDocs (エムケイドックス)は、 Markdown形式で書くだけでウェブサイトが作成できる静的サイトジェネレータです。MkDocsを使うと、データベースを使用しないで、静的なウェブサイトを簡単に作成できます。

MkDocsは、pythonで開発された静的サイトジェネレータ―です。MkDocsを動かすには、まずはpythonをインストールする必要があります。pythonがインストールされている環境なら、pipコマンドでMkDocs本体をインストールするだけでサイト制作環境の構築は完了です。必要なら、好きなテーマ(デザイン)を選んでインストールしても良いでしょう。

一連のインストール作業やコンテンツ作成作業にデータベースは必要ありません。MkDocsでは、データベース環境を構築する必要がなく、また、コンテンツ追加のためにHTMLやCSSを書く必要もありません。Markdown記法を覚えるだけで静的なウェブサイトが簡単に作成できます。

静的サイトジェネレータの利点

静的サイトジェネレータ(SSG=Static Site Generator)とは、何らかの言語で書いたコードから、HTML/CSS/JavaScriptによる静的なウェブサイトを生成するツールのことです。 静的サイトジェネレータの利点は、セキュリティ、表示速度、SEOにあります。

MkDocsのような静的サイトジェネレータでは、データベースを使用しないため、データベースにまつわる脆弱性が存在しません。WordpressのようなCMSとは異なり管理画面が無いので、パスワードが破られて乗っ取られる心配もありません。

ユーザーのリクエストに対しては、あらかじめ作成された静的なウェブページを返すだけです。ユーザーのリクエストがあった時点でデータベースから記事を読み出したり、サーバー上で何らかのプログラム処理をした結果を返すわけではないので、表示は非常に高速です。

ページ遷移しないで表示を切り替えるシングルページアプリケーション(SPA)は、SEO面では不利になりがちです。一方、静的サイトジェネレータでは、SEOに有利な静的なHTMLファイルでウェブサイトを構築できます。

MkDocs の特徴

MkDocs には、以下の特徴があります。

  • pythonで開発された静的サイトジェネレータ
  • コマンドラインで、python、および、MkDocsをインストールするだけでサイト制作環境の構築は完了
  • 記事の追加は、拡張子が「.md」のマークダウンファイルをコピーする
  • コピーしたmdファイルは、自動で読み込まれる

MkDocsは、pythonで開発された静的サイトジェネレータ―です。MkDocsを動かすには、まずはpythonをインストールする必要があります。

pythonがインストールされている環境にMkDocs本体をインストールするだけで、サイト制作環境の構築は完了です。必要に応じてテーマを選んでインストールできます。

記事の追加は、拡張子が「.md」のマークダウンファイルをコピーするだけです。新しいmdファイルを追加すると、自動で読み込まれてウェブページ内に新しいリンクが追加されます。

MkDocs を学ぶメリット

MkDocsで求人を検索しましたが、2020年1月時点では「MkDocs」のスキルを指定した求人は確認できませんでした。

MkDocsは、どちらかと言えば、プロジェクト管理のためのドキュメント作成ツール、あるいは、個人サイトなどを簡単に構築するためのツールという側面が強いかもしれません。

もし、静的サイト生成のスキルを身につけて就職や転職を有利にするなら、Gatsby.jsなどのほうが求人需要が高いかもしれません。

MkDocs公式サイト: https://www.mkdocs.org/