Markdown で技術ブログを書き、SEO を最適化する

技術ブログを Markdown で書くのが最も効率的ですが、検索エンジンに好かれるには SEO の「標準的な手順」を踏む必要があります。実践できるフローを紹介します。

1. コンテンツはデータ：frontmatter で駆動する SEO

各記事のタイトル・説明・キーワード・日付を YAML の frontmatter で宣言します：

title: "Article title"
description: "A one-sentence summary that appears in search results"
keywords: ["keyword one", "keyword two"]
pubDate: 2026-07-25

これらのフィールドは <title>、<meta name="description">、<meta name="keywords"> に自動で注入され、HTML を手動で編集する必要はありません。

2. SEO の三本柱

柱	役割
sitemap.xml	クローラーに存在するページを知らせる
robots.txt	クローラーを誘導しサイトマップを指す
JSON-LD	構造化データで記事を記述（著者・公開日・キーワード）

3. ソーシャル共有カード

Open Graph と Twitter Card を設定すると、WeChat、X、Telegram などで記事を共有した際に美しいプレビュー画像が表示されます。

4. 速度こそが順位

静的サイトは既定で実行時 JS を送らず、瞬時に読み込まれます——これは SEO の天然の強みです。CDN/エッジネットワーク（Cloudflare Pages など）でグローバルに高速化すれば、Core Web Vitals は容易に達成できます。

5. コンテンツは Git で管理

ブログ記事はリポジトリ内のただの .md ファイルです：

• 内容を編集 = ファイルを編集 + PR を開く
• 公開 = マージして自動デプロイ
• 履歴 = Git のコミットログ

この「コンテンツをコードとして扱う」アプローチにより、技術ブログは書きやすく、保ちやすくなります。

このブログ自体がこの手法で構築されています——ソースは GitHub にあります。