Markdown記事の画像をNext.jsの最適化配信にのせる【next/imageを使わずfigure化・サイズ自動取得】
- この記事で分かること
- Markdownの画像記法を、rehypeプラグインで<figure>と最適化済みの<img>(srcset付き)に置き換え、画像ファイルのヘッダーからサイズを読んでwidth/heightを付ける実装
- 実際に使った環境
- Next.js 16.3.1(App Router、SSG)/ unified・rehype。src/lib/markdown.ts・local-image-size.ts・next-image-url.tsとして、このブログの記事本文で実際に動いている実装です
- 筆者の結論
- next/imageコンポーネントは使えなくても、画像最適化の本体は/_next/imageというURLなので、そのURLを自分で組み立てれば同じ配信にできる。ただしSVGと許可する幅の設定には落とし穴があった
ブログ記事にスクリーンショットや図解を載せるとき、画像のサイズが大きいままだとページが重くなります。Next.jsには画像を自動でリサイズしてWebPに変換するnext/imageがありますが、このブログでは使えませんでした。記事本文がMarkdownから変換された文字列だからです。
この記事では、next/imageコンポーネントを使わずに、Markdownの画像へ同じ最適化配信をかけるために作った仕組みを紹介します。
🛠 実装してみて分かったこと
画像最適化の実体はnext/imageというコンポーネントではなく、/_next/imageというURLだと知ったのが突破口でした。コンポーネントを使えなくても、そのURLを自分で組み立ててimgタグに書けば、同じ最適化が得られます。ただ、手作業で組む分、許可する幅の設定や、SVGが弾かれる問題など、本来はコンポーネントが隠してくれていた決まりごとに自分で向き合う必要がありました。
使い方: 置き場所とMarkdownの書き方を守るだけ
執筆者から見た使い方は、次の2つだけです。
- 画像を
public/images/blog/<記事のslug>/に置く - Markdownの画像記法で参照する
![]()の中の説明文がalt属性になり、引用符で囲んだ末尾の文字列(タイトル)が、画像の下のキャプションになります。あとは変換処理が、次のようにHTMLを作り直します。
変換で何が起きるか
wrapContentImagesというrehypeプラグインが、パス/images/blog/で始まる画像だけを探して、<figure>で包んだ最適化済みの<img>に置き換えます。A8.netの計測用画像や、自動生成されるOGP画像など、このパスの外にある画像は対象外で、そのまま素の<img>です。
const optimizedImg: Element = {
type: "element",
tagName: "img",
properties: {
src: isSvg ? src : nextImageUrl(src, largestWidth, CONTENT_IMAGE_QUALITY),
...(isSvg
? {}
: {
srcSet: nextImageSrcSet(src, CONTENT_IMAGE_WIDTHS, CONTENT_IMAGE_QUALITY),
sizes: CONTENT_IMAGE_SIZES,
}),
alt,
loading: "lazy",
decoding: "async",
...(size ? { width: size.width, height: size.height } : {}),
},
children: [],
};isSvgの分岐はSVG画像だけの特別扱いで、後で説明します。ポイントを順に見ていきます。
/_next/imageのURLを自分で組み立てる
最適化エンドポイントのURLを作る関数は、次の2つだけです。
export function nextImageUrl(src: string, width: number, quality = 75): string {
return `/_next/image?url=${encodeURIComponent(src)}&w=${width}&q=${quality}`;
}
export function nextImageSrcSet(src: string, widths: number[], quality = 75): string {
return widths.map((w) => `${nextImageUrl(src, w, quality)} ${w}w`).join(", ");
}元の画像のパス(url)、欲しい幅(w)、画質(q)をクエリで渡すと、Next.jsが画像をその幅にリサイズし、ブラウザが対応していればWebPに変換して返します。結果はキャッシュされます。
srcsetとsizesで、画面に合った大きさを選ばせる
srcSetには、同じ画像を640・828・1080・1366pxの4つの幅で用意したURLを並べています。sizesには、画像が実際に表示される幅を伝えます。
const CONTENT_IMAGE_WIDTHS = [640, 828, 1080, 1366];
const CONTENT_IMAGE_SIZES = "(min-width: 1024px) 760px, 100vw";sizesは、PC幅(1024px以上)では本文のカラム幅の760px、それより狭い画面では画面幅いっぱい(100vw)で表示する、という意味です。ブラウザはこの情報と画面の解像度から、srcsetのうち適切な大きさを1つだけ選んでダウンロードします。スマホで1366pxの大きな画像を読み込むことがなくなります。
許可する幅は、next.config.tsに書いておく
/_next/imageは、wに指定できる値を、next.config.tsの設定にある幅に限っています。設定にない幅を指定すると、拒否されます。
const nextConfig: NextConfig = {
images: {
imageSizes: [80, 160, 320],
deviceSizes: [480, 640, 828, 1080, 1366],
},
};このブログでは、記事本文用の幅(640〜1366)に加えて、一覧のサムネイルのような小さい幅(80・160・320)も同じエンドポイントから配信しています。デフォルトの設定のままだと、小さい幅は「wパラメータが許可されていない」というエラーで拒否されるため、実際に使っている幅を明示的に列挙しています。
SVGは最適化の対象から外す
const isSvg = src.toLowerCase().endsWith(".svg");SVGの場合は、/_next/imageを経由させず、元のパスをそのままsrcに使います。理由は2つあります。
- Next.jsは、セキュリティ上の理由でSVGの最適化をデフォルトで拒否します。許可する設定を入れない限り、SVGを渡すと400エラーになります
- SVGはもともとベクター形式で、拡大縮小しても画質が落ちません。リサイズして配信し直す意味が薄いです
空のaltは、ビルド時に警告する
if (!alt.trim()) {
console.warn(
`[markdown] alt属性が空の画像があります: ${src}${sourceLabel ? ` (${sourceLabel})` : ""}`
);
}altが空の画像があると、ビルドのログに警告が出ます。表示を止めるわけではありませんが、書き忘れに気づく仕組みにしています。どの記事の画像かも分かるよう、記事のslugを一緒に表示します。
pタグの中にfigureを残さない
Markdownの画像は、通常<p><img></p>のように、段落の中の唯一の子として出力されます。そのままだと<p>の中に<figure>が入ることになり、HTMLとして不正です。そのため、段落の子がこの画像1つだけの場合は、段落ごと<figure>に差し替えています。
if (parent.type === "element" && parent.tagName === "p" && parent.children.length === 1) {
Object.assign(parent, figure);
} else {
parent.children[index] = figure;
}画像サイズを、外部パッケージなしで読み取る
<img>にwidthとheightを付けておくと、画像の読み込みが終わる前から表示スペースが確保されます。付けていないと、画像が届いた瞬間に後ろの文章が押し下げられ、読んでいる位置がずれます。これはレイアウトシフトと呼ばれ、Googleが重視するページ体験の指標の一つです。
サイズは、画像ファイルの先頭部分(ヘッダー)に書かれています。それを読む関数を、画像処理用のパッケージを入れずに自前で書きました。
export function getLocalImageSize(publicPath: string): { width: number; height: number } | null {
if (!publicPath.startsWith("/")) return null;
const filePath = path.join(process.cwd(), "public", publicPath);
let buffer: Buffer;
try {
buffer = fs.readFileSync(filePath);
} catch {
return null;
}
return (
readPngSize(buffer) ?? readGifSize(buffer) ?? readWebpSize(buffer) ?? readJpegSize(buffer)
);
}対応しているのは、PNG・GIF・WebP・JPEGの4形式です。ファイルを読めない、または形式を判定できない場合はnullを返し、呼び出し側はwidthとheightを付けずに描画します。サイズが取れなくても、画像自体は表示されます。
PNGは、決まった位置を読むだけ
PNGは、ファイルの先頭に決まったシグネチャがあり、幅と高さが決まった位置(16バイト目と20バイト目)に4バイトずつ入っています。
function readPngSize(buf: Buffer): { width: number; height: number } | null {
const isPng =
buf.length >= 24 &&
buf.readUInt32BE(0) === 0x89504e47 &&
buf.readUInt32BE(4) === 0x0d0a1a0a;
if (!isPng) return null;
return { width: buf.readUInt32BE(16), height: buf.readUInt32BE(20) };
}JPEGは、マーカーをたどって探す
JPEGは位置が固定ではなく、ファイル内を「マーカー」という目印でたどりながら、幅と高さが入っているSOF(Start Of Frame)マーカーを探す必要があります。
while (offset < buf.length - 9) {
if (buf[offset] !== 0xff) {
offset++;
continue;
}
const marker = buf[offset + 1];
const isSofMarker =
marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc;
if (isSofMarker) {
const height = buf.readUInt16BE(offset + 5);
const width = buf.readUInt16BE(offset + 7);
return { width, height };
}
const segmentLength = buf.readUInt16BE(offset + 2);
offset += 2 + segmentLength;
}マーカーが見つかっても、それがSOFでなければ、そのセグメントの長さ(segmentLength)だけ読み飛ばして、次のマーカーへ進みます。0xc4・0xc8・0xccはSOFと同じ範囲の番号を持ちながら、別の用途のマーカーなので除外しています。
なお、この関数はヘッダーだけでなくファイル全体を読み込んでいます。記事用のスクリーンショットや図解は数MB以下を想定しているため、実装を単純にする方を選びました。
表示のCSS
最後に、見た目を整えるCSSです。<figure class="content-image">だけを対象にしています。
.prose figure.content-image img {
display: block;
width: 100%;
height: auto;
border-radius: 0.75rem;
border: 1px solid var(--border-color);
}width: 100%とheight: autoの組み合わせで、width・height属性で確保した縦横比を保ったまま、本文の幅いっぱいに画像が広がります。
よくある質問
Q. next/imageコンポーネントをそのまま使えないのはなぜですか?
A. このブログの記事本文は、MarkdownをHTML文字列に変換して出力しています。画像はその文字列の中にある生のimgタグで、Reactのコンポーネントとしては存在しません。そのため<Image>を差し込めず、画像最適化のエンドポイント(/_next/image)のURLを自分で組み立てる形にしました。
Q. 画像のwidthとheightは、なぜ付けるのですか?
A. 画像の読み込みが終わる前に、表示スペースを確保するためです。付けないと、読み込み完了時に画像の分だけ後ろの文章が押し下げられ、読んでいる位置がずれます(レイアウトシフト)。付けておけば、画像が届く前からスペースが取られます。
Q. SVG画像を最適化の対象から外しているのはなぜですか?
A. Next.jsはセキュリティ上の理由で、SVGの最適化をデフォルトで拒否します。設定で許可しない限り、/_next/imageにSVGを渡すと400エラーになります。また、SVGはもともとベクター形式でリサイズ配信の意味も薄いので、元のパスをそのまま使っています。
まとめ
Markdown由来のHTMLではnext/imageコンポーネントが使えませんが、最適化の実体は/_next/imageというURLなので、そのURLを組み立てれば同じ配信が得られました。srcsetとsizesで端末に合った大きさを選ばせ、width・heightでレイアウトシフトを防ぎ、figureでキャプションを付けています。
コンポーネントが隠してくれていた決まりごと(許可する幅、SVGの扱い)は、自分で組む場合には自分で扱う必要があります。その分、何が起きているかを一つずつ理解できたのは収穫でした。