FAQPage 里的 "text"字段 可以包含HTML富文本 包括图片和视频

最后更新:
1900-01-01 00:00

摘要:FAQPage 里的 "text"字段 可以包含HTML富文本 包括图片和视频


一、Google 官方规范说明(权威结论)

Google 官方 FAQPage 结构化数据规范 中,
acceptedAnswer.textQuestion.name 都被定义为 纯文本字段

text: The answer to the question.
Do not include any HTML tags or other markup.

 翻译:

text 字段应仅包含答案内容,不应包含任何 HTML 标签或标记。


 二、实践中 Google 的行为

虽然 JSON-LD 技术上支持字符串里嵌入 HTML(比如 <p><a> 等),
但 Google 的结构化数据解析器会:

  • 自动 去除 HTML 标签

  • 只保留纯文本内容;

  • 甚至可能因为富文本、图片或视频标签导致 FAQ 无法在搜索结果中显示。

所以:

 不建议在 "text" 字段中使用 HTML、富文本、图片或视频。


三、正确的处理方式

内容类型建议方式
普通文字段落直接写入 "text" 字段(自动换行会被忽略)。
超链接用纯文字方式写 URL(如 Visit www.melouris.com for details.),不要用 <a>
图片或视频仅在网页可视内容中展示,不要放进结构化数据中。
换行/段落\n 表示换行即可,JSON-LD 会当作连续段落。

示例(正确写法)

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Can the candle be used outdoors?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Yes, the candle is weather-resistant and suitable for outdoor use.\nHowever, avoid direct rain exposure for long periods."
      }
    }
  ]
}

 示例(错误写法,Google 不推荐)

{
  "@type": "Answer",
  "text": "<p>Yes, it is weather-resistant.</p><img src='candle.jpg'>"
}

?? Google 会去掉标签,只留下 “Yes, it is weather-resistant.”
且这种写法有风险被视为结构无效。


四、实用建议(总结)

项目是否允许说明
HTML 标签?会被剥离或导致无效
图片 <img>?无法识别,容易报错
视频 <iframe><video>?不会显示在 FAQ 结果中
换行符 \n?可读性好
Markdown(如 **bold**?只会被当作普通字符
纯文本内容?官方推荐

一句话总结:

"text" 字段必须是纯文本,不能放 HTML、图片或视频。
这些富媒体可以放在网页内容区(用户可见的 FAQ 区域),
但不应出现在结构化数据 JSON 里。