必须使用 https://schema.org/faqpage 作为唯一顶层类型,每个问题需独立声明 itemscope itemtype="https://schema.org/question" 并通过 itemprop="mainentity" 关联,答案用嵌套的 https://schema.org/answer,text 必须为纯文本。

必须用 https://schema.org/FAQPage,且每个问题必须独立声明 itemscope itemtype="https://schema.org/Question" 和对应 Answer,否则 Google 不识别为 FAQ 富媒体结果。
FAQPage 是唯一有效的顶层类型
Google 只认可 https://schema.org/FAQPage 作为整页 FAQ 的根类型。写成 http://schema.org/FAQPage、https://schema.org/faqpage(小写)、https://schema.org/FAQPage/(末尾斜杠)或任何自定义 URL,都会导致结构化数据测试工具报 “Invalid itemtype” 并静默丢弃。
使用 PptxGenJS 和 Python 解析,将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint(.pptx)演示文稿。
- 错误示例:
<main itemscope itemtype="FAQPage"></main>→ 缺协议、缺域名 - 错误示例:
<section itemscope itemtype="https://schema.org/FAQPage"></section>→ 正确格式,但仅声明顶层,不包含具体问答 - FAQPage 本身不带任何可展示字段,所有问题和答案必须通过嵌套的
Question和Answer实体提供
每个 Question 必须独立 itemscope + itemtype
不能把多个问题塞进同一个 itemscope 容器里——Google 会当成一个问答对处理,其余内容被忽略。每个 <div> 或 <code><section></section> 包裹的问题都需单独声明作用域。
-
itemprop="mainEntity"必须指向每个Question实体,且该元素上必须同时有itemscope itemtype="https://schema.org/Question" - 常见错误:在父级
FAQPage容器里写<p itemprop="name">…</p>→ 没有子itemscope,name不会被识别为问题标题 - 正确结构:
<div itemprop="mainEntity" itemscope itemtype="https://schema.org/Question"> <h3 itemprop="name">…</h3> <div itemprop="acceptedAnswer" itemscope itemtype="https://schema.org/Answer"><div itemprop="text">…</div></div> </div>
Answer 的 text 字段必须是纯文本,且不可嵌套 HTML
itemprop="text" 的值默认取元素的 textContent。如果里面含 <strong></strong>、<ul></ul> 或换行符,Google 可能截断、过滤,甚至拒绝索引整个 FAQ 块。
- 错误写法:
<div itemprop="text">支持<em>微信</em>和<em>支付宝</em>支付</div>→ 提取值含标签,易被判定为格式异常 - 推荐做法:用纯文本;如需强调,改用
<meta itemprop="text" content="支持微信和支付宝支付">隐藏声明 - 日期、价格等结构化字段不能出现在
text中——它们应单独用datePublished、price等属性声明,且必须匹配所属类型(如Answer不支持price)
FAQPage 页面不能混用其他主类型
一个页面只能有一个明确的主实体。若同时声明 FAQPage 和 Article 或 Organization 在同一顶级容器(如 <main></main>),Google Rich Results Test 会报冲突或只识别其中一个。
- 常见误操作:在
<main itemscope itemtype="https://schema.org/FAQPage"></main>里又加<header itemscope itemtype="https://schema.org/Organization"></header>→ 若Organization不是 FAQ 的组成部分(比如只是页脚版权信息),应移出FAQPage作用域 - 若 FAQ 是某篇文章的子模块,应让
FAQPage嵌套在Article内,并用itemprop="hasPart"关联,而非平级并列 - 验证时务必用 Google Rich Results Test 实时抓取,不要依赖缓存——FAQ 富媒体卡片上线延迟高,且对
mainEntity的数量、嵌套深度、文本长度敏感










