satori + resvg でOGP画像をビルド時自動生成

各記事のタイトルやタグからOGP画像をビルド時に自動生成する手順をまとめました。

2025-11-05

satori + resvg でOGP画像をビルド時自動生成

satori + resvg でOGP画像をビルド時自動生成

SNSシェア時の見栄えを統一するため、satori でSVGを生成し、resvg でPNG化して public/ogp/[slug].png に保存します。

流れ

  • ビルド前に Notion から記事メタデータ(title, slug, tags, date)を取得
  • satori でテンプレートに流し込み、1200×630 のSVGを生成
  • resvgでPNG化し、public/ogp/ へ書き出し
  • <meta property="og:image"> に対応するパスを設定
  • メリット

  • 手作業不要で 全記事にOGPが行き渡る
  • デザインの統一と変更が容易(テンプレ1箇所を調整するだけ)
  • 画像ファイルをリポジトリに含めず、ビルドで都度生成 も可能
  • 見た目にこだわるほど クリック率 が変わるので、最初に仕組み化しておくのが吉。