コンテンツ制作の共通言語：Markdown

静的サイトジェネレーター（SSG）の多くは、記事の執筆に Markdown（マークダウン） を採用しています。なぜ HTML を直接書かずに Markdown を使うのでしょうか？

1. Markdown の特性：シンプルで「壊れない」

Markdown は、プレーンテキストに記号（# や *）を添えるだけで構造を指定できる軽量マークアップ言語です。

• 読みやすさ: 装飾がなくても、テキストファイルとして十分に構造が理解できます。
• 書きやすさ: HTML タグをいちいち閉じる手間がなく、思考を妨げずに執筆に集中できます。
• Git との親和性: プレーンテキストであるため、Git での差分（diff）が非常に見やすく、変更履歴の管理が容易です。

2. なぜ SSG と相性が良いのか？

SSG の最大の役割は、「コンテンツ（Markdown）」と「見た目（テンプレート）」を分離することにあります。

• 自動変換: SSG は Markdown を読み取り、自動的に最適化された HTML へ変換してくれます。
• メタデータ (Frontmatter): 記事のタイトルや公開日を Markdown の冒頭に「データ」として持たせることができ、サイト全体の管理がプログラム的に行えます。
• MDX の可能性: 特に Astro などでは、Markdown の中にコンポーネントを埋め込める MDX をサポートしており、記事内に動的なチャートやインタラクティブな要素を簡単に挿入できます。

3. 「プロの執筆スタイル」への入り口

プロのエンジニアが技術ドキュメントやブログを書く際、Markdown はもはや標準です。このシンプルな記述法をマスターすることは、SSG を使いこなすだけでなく、エンジニアリングの世界でのコミュニケーション能力を高めることにも直結します。

結論

Markdown は、あなたの考えを「データ」として正しく保存し、SSG というエンジンを通して「美しいサイト」へと変換するための架け橋です。本サイトの原稿もすべて Markdown で管理されており、誰でも修正・改善に参加できる（GitHub/Bitbucketとの相性）という強みを生み出しています。