itemtype必须与itemscope成对出现且值为完整HTTPS URL,嵌套类型需独立声明,时间/时长等字段须用标准语义标签;缺一不可,否则结构化数据将被搜索引擎静默忽略。

直接写 itemtype 不会生效,它必须和 itemscope 成对出现在同一个 HTML 元素上,且值必须是 Schema.org 的完整 HTTPS URL —— 写错一个字符,Google Rich Results Test 就会静默忽略整块结构化数据。
itemtype 必须搭配 itemscope 才能启动微数据解析
很多人复制了 itemtype="https://schema.org/Movie" 却没效果,原因几乎全是漏了 itemscope。浏览器和搜索引擎只在遇到带 itemscope 的元素时,才开始收集其内部的 itemprop。
- ✅ 正确:
<div itemscope itemtype="https://schema.org/Movie"><h1 itemprop="name">阿凡达</h1></div> - ❌ 无效:
<div itemtype="https://schema.org/Movie"><h1 itemprop="name">阿凡达</h1></div>(缺itemscope) - ❌ 无效:
<div itemscope><h1 itemtype="https://schema.org/Movie" itemprop="name">阿凡达</h1></div>(itemtype不能放在子元素上)
URL 必须完整、大小写敏感、不可省略协议
itemtype 不是标签名或缩写,它是解析器用来加载外部词汇表的 URI。拼错、少斜杠、大小写错误、用 HTTP 协议,都会导致整个结构化数据被丢弃。
- ✅ 正确:
https://schema.org/Restaurant、https://schema.org/Person - ❌ 错误:
http://schema.org/Restaurant(协议不被接受) - ❌ 错误:
https://schema.org/restaurant(大小写敏感,必须大写 R) - ❌ 错误:
https://schema.org/Restaurant/(末尾斜杠导致 404) - ❌ 错误:
schema.org/Restaurant(缺协议,被当相对路径)
嵌套类型必须各自声明 itemscope + itemtype
当一个实体包含另一个实体(比如电影的导演是 Person),不能靠父级“继承”类型,必须为子实体新建独立作用域。
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML,微信编辑器可直接渲染,无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
立即学习“前端免费学习笔记(深入)”;
- ✅ 正确:
<div itemscope itemtype="https://schema.org/Movie"> <span itemprop="name">泰坦尼克号</span><div itemprop="director" itemscope itemtype="https://schema.org/Person"><span itemprop="name">詹姆斯·卡梅隆</span></div> </div> - ❌ 错误:
<div itemscope itemtype="https://schema.org/Movie"><span itemprop="director">詹姆斯·卡梅隆</span></div>(director值没声明类型,会被当字符串丢弃) - ⚠️ 注意:嵌套容器不能隔层 ——
itemprop="director"的直接子元素必须是itemscope itemtype="https://schema.org/Person",中间插<p></p>或空<span></span>都可能导致解析失败
时间、时长等字段必须用标准格式+语义标签
Schema.org 对 datePublished、duration 等字段有硬性格式要求,仅靠 itemprop 绑定文本远远不够。
-
datePublished必须用<time datetime="YYYY-MM-DD"></time>,例如:<time itemprop="datePublished" datetime="1997-12-19">1997年</time> -
duration必须用 ISO 8601 格式,如PT3H15M(3小时15分),不能写"3小时15分"或195分钟 - 常见翻车点:
<span itemprop="datePublished">1997年</span>→ Google 无法提取年份,整个 Movie 结构可能被降权
最容易被忽略的是:即使所有 HTML 写对了,如果地址用纯文本、电话加了“电话:”前缀、logo 图片没带 alt 或 itemprop="logo" 放在 <img alt="HTML itemtype属性使用实例" > 上,富媒体展示依然会失败 —— 结构化数据不是“写了就有效”,而是“每个字段都得同时满足机器可读 + 用户可见 + 类型匹配”。


















