なぜブログを移行したか
自分のドメインでシンプルに記事を管理するため、ブログ基盤をNext.js 16 + MDX + Tailwind CSS v4で再構築しました。MDXファイルを1つ配置すれば記事として公開され、シンタックスハイライトやOGP画像生成、多言語ルーティングがすべてビルド時に完了する構成にしています。
content/blog/<slug>/{ja,en}.mdx
├─ gray-matter : Frontmatter(メタデータ・FAQ・日付)抽出
├─ Shiki / KaTeX : ビルド時のコードハイライト・数式レンダリング
├─ ImageResponse : 1200×630 OGP画像の静的生成
└─ Next.js SSG : ゼロランタイムの静的HTML出力(/ja/blog/<slug>, /en/blog/<slug>)ディレクトリ構成
.
├── app/ # Next.js App Router
│ └── [locale]/
│ └── blog/
│ └── [slug]/
│ ├── page.tsx # Blog post page (RSC)
│ └── opengraph-image.tsx # OG image (build-time)
├── content/blog/ # Blog posts (MDX files)
│ └── hello-world/
│ ├── ja.mdx # Japanese version
│ └── en.mdx # English version
├── components/blog/ # Blog-specific components
├── lib/
│ ├── blog.ts # Post metadata, pagination
│ ├── mdx.ts # MDX compilation pipeline
│ └── image-upload.ts # Image optimization pipeline
└── public/images/blog/ # Local image fallback (dev)各記事は content/blog/<slug>/ ディレクトリに ja.mdx と en.mdx を配置するだけで管理できます。データベースを持たず、Gitリポジトリのファイルシステムをそのままデータソースとして扱います。
MDXとビルド時ハイライト
frontmatterにメタデータを記述し、本文をMarkdown(必要に応じてJSXコンポーネント)で記述します。
title: "ブログを移行しました"
description: "ブログ基盤を作り直した記録です"
date: "2026-03-16"
tags: ["blog", "nextjs"]
published: truepublished: false に設定すれば下書き状態になり、本番ビルドの一覧やルーティングからは除外されます。
コードブロックはShikiでビルド時にハイライトされ、ライトモードとダークモードの双方のトークンカラーをCSS変数として事前出力します。クライアント側でのハイライト用JavaScriptは実行されません。
const prettyCodeOptions: PrettyCodeOptions = {
theme: {
dark: "github-dark-dimmed",
light: "github-light",
},
keepBackground: false,
};数式もKaTeXでビルド時に変換されます。
画像パイプライン: クリップボードからの自動WebP変換
記事執筆時の画像配置を省力化するため、エディタのテキストエリアに画像をペースト(Ctrl+V / Cmd+V)した際に以下の処理を自動実行するパイプラインを用意しました。
- クリップボードから画像データを抽出
- プレースホルダー(
![uploading...]())をカーソル位置に挿入 - Sharpで最適化(WebP変換、最大幅1920px、品質75%)
- Cloudflare R2にアップロード(開発環境ではローカル保存)
- プレースホルダーをMarkdown画像構文に置換
export async function optimizeImage(buffer: Buffer) {
const image = sharp(buffer);
const metadata = await image.metadata();
const needsResize = metadata.width !== undefined && metadata.width > 1920;
const pipeline = needsResize ? image.resize({ width: 1920 }) : image;
return pipeline
.webp({ quality: 75, effort: 4 })
.toBuffer({ resolveWithObject: true });
}MIMEタイプのチェックに加えてSharpでマジックバイトを検証し、ファイルサイズは3MB上限、同時アップロードは2件までに制限しています。
SSGによる静的サイト生成
すべての記事ページは generateStaticParams によってビルド時に静的生成されます。
export async function generateStaticParams() {
const slugs = getPostSlugs();
const params: { locale: string; slug: string }[] = [];
for (const slug of slugs) {
for (const locale of ["ja", "en"]) {
if (fs.existsSync(`content/blog/${slug}/${locale}.mdx`)) {
params.push({ locale, slug });
}
}
}
return params;
}MDXのコンパイル、Shikiによるシンタックスハイライト、KaTeXの数式レンダリングはすべてビルド時に完了し、ブラウザにはReact Server Componentsで生成された静的HTMLが配信されます。
OGP画像と構造化データの自動生成
SNS共有時のOGP画像も、Next.jsの ImageResponse(Satoriベース)で全記事に対してビルド時に生成しています。
export default async function OGImage({ params }) {
const { locale, slug } = await params;
const post = getPost(slug, locale as Locale);
return new ImageResponse(
<div style={{
background: "linear-gradient(135deg, #0f172a, #1e293b)",
// title, description, site name, date...
}}>
{post.meta.title}
</div>,
{ width: 1200, height: 630 }
);
}フロントマターのタイトル・説明文・日付から1200×630pxのPNG画像を出力し、TechArticle・BreadcrumbList・FAQPage の構造化データ(JSON-LD)も同時に出力します。
デザインシステムと多言語対応(i18n)
配色とタイポグラフィはCSSカスタムプロパティとTailwind CSS v4のユーティリティクラスで管理しています。
:root {
--background: oklch(1 0 0);
--foreground: oklch(0.145 0 0);
--primary: oklch(0.546 0.245 262.881);
--muted: oklch(0.97 0 0);
}
.dark {
--background: oklch(0.145 0 0);
--foreground: oklch(0.985 0 0);
}多言語対応は next-intl を使用し、記事ディレクトリに ja.mdx と en.mdx を配置することで /ja/blog/<slug> と /en/blog/<slug> の双方のルートと hreflang 付きサイトマップを自動生成しています。
まとめ
- MDXファイルを1つ追加するだけで日英の記事ページ・サイトマップ・OGP画像・JSON-LDが生成される構成にしました
- 画像のWebP変換・リサイズ、コードハイライト、数式レンダリングをビルドパイプラインに統合し、執筆時の手作業をなくしています