2024.06.14 Webサイト

MarkdownでWebサイトを作る3つの方法【2026年版】

Markdownで書いたテキストは、変換ツールを一つ通すだけでWebサイトとして公開できます。とはいえ、どの経路を選ぶかで作業量も運用コストも変わり、2026年は定番だったMkDocs系に大きな地殻変動が起きているため、道具選びの前提そのものが動きました。この記事では、.mdファイルがWebページに変わる仕組みから、静的サイトジェネレータ・GitHub Pages・ノーコードサービスという3ルートの選定基準、そして避けるべき場面までを整理します。

まとめ

  • 選定の軸は更新頻度です。継続更新する技術ドキュメントは静的サイトジェネレータ、単発の資料公開はGitHub Pages、環境構築を避けたい非エンジニアはノーコードサービスが向きます。
  • Markdownがサイトになる原理は「MarkdownパーサがHTMLを出力する」だけで、python -m markdown page.md の1コマンドでHTML断片が得られます。
  • 2026年にMkDocs系を新規採用するなら判断材料が変わりました。Material for MkDocsは2025年11月11日公開の9.7.0を機能追加としての最終版とし、MkDocs本体の次期版2.0はプラグイン機構の廃止と移行パス無しが公表されています。
  • GitHub Pagesのネイティブビルドで動くJekyllは3.10.0に固定されています。最新の4系を使うにはGitHub Actionsのワークフローが要ります。
  • 旧来この記事で紹介していたMarkdownAIは、2026年8月時点でも公式サイトの表記がβのままで、料金プランの記載は確認できません。

MarkdownがHTMLに変わる仕組みとパーサの役割

Markdownは見出しやリストを記号で表す軽量マークアップ言語で、それ自体はブラウザが解釈できる形式ではありません。間に入るMarkdownパーサがHTMLへ変換し、その出力をブラウザが表示します。ここを押さえておくと、次章のルート選定で「どのツールが何を肩代わりしているのか」を読み取れます。

変換の実体はHTML断片の生成

もっとも単純な変換はコマンド1行で済みます。macOS上のPython 3.9.6環境にPython-Markdown 3.9を入れて実行した結果が次のとおりです（Python 3.14.6＋Markdown 3.10.3でも出力は同一でした）。

$ pip install markdown
$ printf '# 見出し\n\n- 箇条書き\n\n**強調**\n' > page.md
$ python -m markdown page.md
<h1>見出し</h1>
<ul>
<li>箇条書き</li>
</ul>
<p><strong>強調</strong></p>

出力は <html> も <head> も含まないHTML断片です。つまりMarkdown単体では、デザインもナビゲーションも付きません。同種の変換ツールにはドキュメント変換の定番であるPandocなどもありますが、いずれも役割は同じで、断片としてのHTMLを吐き出すところまでを担当します。静的サイトジェネレータが引き受けるのは、この断片にテンプレート・CSS・目次・検索を被せ、複数ページをまとめて1つのサイトとして書き出す工程です。1ページだけHTMLへ変換するなら上のコマンドで完了しますが、ページが増えた時点でジェネレータが要ります。ChatGPTやClaudeが回答をMarkdownで返すのも同じ構造の話で、AIの出力をそのまま .md として保存しておけば、この変換経路にそのまま載せられます。

公開までの3ルートと選定基準

Markdownをサイトにする経路は大きく3つに分かれます。判断軸は「更新頻度」と「サーバーやコマンド操作をどこまで自分で引き受けるか」の2点で、機能の多さではありません。

ルート 代表ツール 必要な知識 費用 向く用途
1. 静的サイトジェネレータ Astro / Hugo / MkDocs CLI・Git ホスティング次第（無料枠あり） 継続更新するドキュメント・ブログ
2. GitHub Pages単体 Jekyll 3.10.0（固定） Gitのみ 無料（上限あり） 単発の資料・READMEの公開
3. ノーコードサービス MarkdownAI（β） 不要 公式に料金記載なし 環境構築を避けたい非エンジニア

ルート1：静的サイトジェネレータ＋ホスティング

.mdファイル群を入力として、目次・検索・テーマ適用済みの静的HTMLを一括生成する方式です。ページ数が増えても構造が破綻せず、Gitで差分管理できる点が強みになります。用途で選び分けるなら、既存の .md 資産をほぼそのまま載せたいときはAstro（7.2.1／2026年8月11日公開）、Go製でビルド時間の短さを売りにするのがHugo（v0.165.0／2026年8月12日公開）、技術ドキュメント特化ならMkDocsという整理です。

作業量の目安として、MkDocsで雛形を作ってビルドするまでの実行ログを示します。

$ pip install mkdocs mkdocs-material
$ mkdocs new mysite
INFO    -  Writing config file: mysite/mkdocs.yml
INFO    -  Writing initial docs: mysite/docs/index.md
$ cd mysite && mkdocs build
INFO    -  Documentation built in 1.17 seconds

生成された site ディレクトリには index.html に加えて404ページ、sitemap.xml、全文検索用のインデックスが含まれ、Materialテーマ込みで実測2.5MBでした。このディレクトリをレンタルサーバーへ置くか、GitHub Pagesへデプロイすれば公開は完了します。テーマ設定や日本語対応まで含む手順は、MkDocsの使い方｜インストールからMaterialテーマ・日本語対応・GitHub Pages公開まで【2026年版】にまとめてあります。ただしMkDocs系は2026年に採用判断の前提が変わったため、後述の判断材料を先に確認してください。

ルート2：GitHub Pages単体

リポジトリに .md を置き、Settingsの Pages で公開ソースを「Deploy from a branch」に設定するだけで公開できます。ローカルにNode.jsもPythonも要らず、ブラウザ操作だけで完結する点が最大の利点です。公式ドキュメントは、プッシュ後にサイトへ反映されるまで最大10分かかる場合があると案内しています。

注意点はJekyllの版です。GitHub Pagesのネイティブビルドは github-pages gem v232 経由で Jekyll 3.10.0 に固定されており、アップストリームの最新版である4系（4.4.1／2025年1月29日公開）は動きません。4系や任意のプラグインを使いたい場合はGitHub Actionsのカスタムワークフローを組む必要があり、その時点で「Gitだけで完結」という利点は失われます。無料枠の上限は、公開サイトの容量が1GBまで、帯域が月100GBのソフトリミット、ビルドが1時間あたり10回のソフトリミットです。ビルド回数の制限は、Actionsのカスタムワークフローで公開する場合には適用されません。料金体系や独自ドメインの扱いを含む詳細は、GitHub Pagesとは？できること・使い方・料金をわかりやすく解説で整理しています。

ルート3：ノーコード型のMarkdownサービス

ブラウザ上でMarkdownを入力し、そのままURLを発行する形式のサービスです。サーバーもGitも不要な代わりに、独自ドメインの可否・バックアップ・エクスポートの手段がサービス側の仕様に縛られます。国内で名前が挙がるMarkdownAIは2024年の公開以来β表記が続いており、この種のサービスを選ぶ際は次章の判断材料を確認してください。

2026年にMkDocs系を選ぶ前の判断材料

Markdownからドキュメントサイトを作る定番はMkDocsとMaterial for MkDocsですが、2026年は前提が変わりました。手元でmkdocs 1.6.1とmkdocs-material 9.7.7を入れてビルドすると、ログの冒頭に開発チームの警告バナーが出ます。

$ mkdocs build
 │  ⚠  Warning from the Material for MkDocs team
 │
 │  MkDocs 2.0, the underlying framework of Material for MkDocs,
 │  will introduce backward-incompatible changes, including:
 │
 │  × All plugins will stop working – the plugin system has been removed
 │  × All theme overrides will break – the theming system has been rewritten
 │  × No migration path exists – existing projects cannot be upgraded
 │  × Closed contribution model – community members can't report bugs
 │  × Currently unlicensed – unsuitable for production use
（中略）
INFO    -  Documentation built in 1.17 seconds

警告そのものはmkdocs-material 9.7.2（2026年2月18日公開）で追加され、上に引用した文面は文言を改訂した9.7.5（2026年3月10日公開）以降のものです。CIログを汚したくない場合は、環境変数 NO_MKDOCS_2_WARNING=1 を付けて実行するとバナーは表示されません（9.7.7で動作確認済み）。

背景を数字で押さえると、判断はそれほど難しくありません。MkDocs 1.6.1はPyPIで2024年8月30日に公開されて以降リリースが止まり、次期版のMkDocs 2.0はプラグイン機構の削除・テーマ機構の書き直し・設定形式のYAMLからTOMLへの変更を予定しつつ、移行パスを用意しないと明言されています。リリース日は未定で、ライセンスも未指定のままです。テーマ側のMaterial for MkDocsは2025年11月11日に9.7.0を機能追加としての最終版と宣言し、以後は重大なバグとセキュリティ問題の修正を少なくとも今後12か月は継続する（原文は “critical bugs and security issues for 12 month at least”）と表明しています。この表明は履行されており、2026年7月17日公開の9.7.7では検索候補のDOMベースXSS脆弱性が修正されています。後継として同チームが開発するZensicalはMITライセンスで公開されていますが、バージョンは0.0.54、PyPIの開発ステータス表記は「3 – Alpha」です。

結論としては、既存のMkDocsサイトは動き続けるので慌てて移行する必要はありません。新規に構築するなら mkdocs==1.6.1 のようにバージョンを固定し、プラグイン依存を最小限に抑える前提で使ってください。MkDocs 2.0は本番採用の判断材料が揃っておらず、Zensicalもアルファ版のため業務ドキュメントの基盤には早すぎます。プラグインを多用する構成を今から新規に組むなら、更新が継続しているAstroやHugoを選ぶほうが数年後の移行コストは小さく済みます。各版の詳細な比較はMkDocsの使い方の最新動向の章を参照してください。

MarkdownAIなどノーコードサービスの現在地

ブラウザだけでMarkdownからサイトを公開できるサービスとして、MarkdownAIがあります。2026年8月時点で公式サイト（mdown.ai）のヘッダー表記は「MarkdownAI β」のままで、著作権表示は MarkdownAI Inc. となっています。公式サイト上に料金表やプラン比較の記載は確認できず、費用について参照できるのは、運営元が公式noteで「無料サイト制作ツール」と称している点のみです。「無料プランと有料プランがある」「手頃な価格設定」といった紹介も見かけますが、公式に確認できる根拠はないため、プラン構成と料金は公式サイトの最新表示で確かめてください。

ノーコード型を選ぶ判断材料は、機能の多寡ではなく継続性とデータの持ち出し可否です。β提供のまま続くサービスに事業サイトを預けると、終了時の移行先がありません。書いた原稿を .md ファイルとして手元にも残しておけば、ルート1やルート2へいつでも移せます。

書いたMarkdownの表示確認とビューア

公開前に .md の見た目を確かめる手段は次の3つです。

  • VS Codeのプレビュー：マークダウンファイルを開いた状態でショートカットを押すと、エディタの横に描画結果が並びます。
  • GitHub：リポジトリに置いた .md はブラウザ上で自動的に整形表示されるため、専用のビューアを入れる必要がありません。
  • ローカルサーバー：mkdocs serve のようにテーマ適用後の実際の姿を http://127.0.0.1:8000/ で確認できます。前2者と違い、公開後と同じ見た目を検証できる点が利点です。

マークダウンエディタの選定まで踏み込むなら、執筆効率を左右するMarkdown Live Editorの基本機能と選定基準でリアルタイムプレビュー系の比較軸を扱っています。図表を含む文書であれば、VSCodeでMermaidを使う方法｜記法・図作成・画像出力とAI拡張mermAIdのMermaid記法を併用すると、フローチャートまでMarkdownのまま管理できます。

Markdownでのサイト構築を避けるべき場面

Markdownは万能ではありません。次に当てはまる場合、別の手段を選んだほうが結果的に早く済みます。

最も多い失敗は、編集者がGitもコマンドラインも触らない運用体制で導入してしまうケースです。更新のたびにエンジニアがプルリクエストを処理する構造になると、更新頻度が確実に落ちます。原稿を書く人が自分で公開できない仕組みは、それだけで運用が止まります。この場合は素直にWordPressなどのCMSを選ぶべきです。

ページごとにレイアウトが異なるコーポレートサイトやランディングページも不向きです。Markdownは文書構造の記述に特化しており、段組みや装飾はテーマ側の作り込みに依存します。ページ単位でデザインを変える要件が入れば、結局HTMLとCSSを直接書くことになり、Markdownを挟む意味が薄れてしまいます。

ログイン機能や問い合わせフォームの保存処理など、サーバー側の動的処理が要件の中心にある場合も適しません。静的サイトジェネレータの出力は静的ファイルのみで、フォーム送信は外部サービスへ委ねる前提になります。要件の主軸が動的処理なら、最初からアプリケーションフレームワークで組んだほうが構成は単純です。なお、Reactアプリケーションの内部でMarkdownを描画したいという要件は静的サイト構築とは別の話で、その場合はreact-markdownの使い方｜GFM表示とrehype-sanitizeで安全にMarkdownを描画するで扱うライブラリを使います。

よくある質問

Markdownで作ったWebサイトは無料で公開できますか？

GitHub Pagesを使えば無料で公開できます。ただしサイト容量1GBの上限と、帯域・ビルド回数のソフトリミットがあるため、画像や動画を多く抱えるサイトでは外部ストレージの併用を検討してください。独自ドメインを使う場合は、その取得費用が別途かかります。

生成AIが出力したMarkdownをそのままサイトに載せられますか？

載せられます。AIの回答をコピーして .md として保存し、静的サイトジェネレータのソースディレクトリへ置くか、GitHubのリポジトリへコミットすれば公開できる状態になります。HTMLへ変換し直す工程が要らないため、AIを執筆に使う運用ではMarkdownを保存形式にしておくと手数が減ります。

MarkdownAIは無料で使えますか？

2026年8月時点で、公式サイト（mdown.ai）に料金表やプランの記載はありません。運営元は公式noteで「無料サイト制作ツール」と表現していますが、サービス自体がβ表記のままのため、費用も提供条件も公式の最新表示で確認してください。

マークダウン記法とは何ですか？

見出しを #、箇条書きを - のように、記号だけで文書構造を表す記法のことです。拡張子は .md を使います。HTMLのようにタグの開閉を書かずに済むぶん、書きながら構造を保てる点が特徴で、GitHubのREADMEや技術ドキュメントで標準的に使われています。

既存のPDF資料をMarkdownのサイトへ移せますか？

変換ツールを使えば移せます。PDFをMarkdownへ変換する具体的な手順は、Marker（marker-pdf）の使い方｜PDFをMarkdown変換する手順と商用ライセンス制約で解説しました。変換後の .md をソースディレクトリへ配置すれば、そのままサイトの1ページとして扱えます。

関連記事

資料請求

RELATED POSTS 関連記事

一覧へ戻る