元数据 // Articles

X 上的 Twitter Card 与 Open Graph

整理 X 在链接预览中如何使用 twitter:* 标签、Open Graph fallback、图片比例和 UI 变化。

日常工作中常说“X 的 OGP”,但更准确地说,X 的链接预览来自 Twitter Cards 延续下来的 X Cards。它可以 fallback 到 Open Graph,因此两者容易混在一起。

Open Graph 是共同基础

Open Graph 用于把网页描述成可用于链接预览的 rich object。基础字段包括 og:title、og:type、og:image、og:url,常常还会加入 og:description 和 og:site_name。

twitter:* 用于 X 的覆盖

X Cards 会优先读取 twitter:title、twitter:description、twitter:image 等专用标签。如果这些值不存在,就可能使用 og:title、og:description、og:image 作为 fallback。

  • 先整理基础 OGP
  • 需要大型 X 卡片时设置 twitter:card 为 summary_large_image
  • 只有 X 需要不同内容时再添加 twitter:*
  • 图片要兼顾 1.91:1 和 2:1 裁切
  • 最终显示会受 X 的 UI 实验和缓存影响

参考信息