itemtype必须是完整https url，如"https://schema.org/person"；作者信息须嵌套在itemscope容器内；itemprop值需按规范提取，姓名用name、邮箱用mailto链接；address标签需配合itemscope使用；url须可访问且返回200。
itemtype必须是完整 HTTPS URL，不能写成 Person 或 schema.org/Person
直接写 itemtype="Person" 或 itemtype="schema.org/Person" 会被 Google Structured Data Testing Tool 和所有主流解析器无视。它不是类名或缩写，而是指向一个外部定义的词汇表地址，必须可 HTTP 访问且返回 200。常见错误包括漏掉 s（http:// 而非 https://）、用相对路径（如 ./Person）、或拼错 URL。
✅ 正确写法：itemtype="https://schema.org/Person"
❌ 错误写法：itemtype="Person"、itemtype="http://schema.org/Person"、itemtype="/vocab/person"
作者信息必须嵌套在 itemscope 容器内，不能单独加 itemprop
itemprop 不是独立语义标签，它只在带 itemscope 和 itemtype 的父容器作用域下才有效。把 itemprop="author" 直接加在 <p></p> 或 <div> 上，但外层没声明类型，结构化数据就完全失效。
<ul><li>作者本身是一个实体（Person），所以要用 <code><div itemscope itemtype="https://schema.org/Person"> 包裹
<li>如果作者是某篇文章的 <code>author 属性，则需嵌套：外层 Article 声明 itemprop="author"，内部紧贴着放 itemscope itemtype="https://schema.org/Person"
<div itemprop="author"><div itemscope itemtype="https://schema.org/Person">…</div></div> 是无效的——itemprop 必须直接绑定到 itemscope 元素上作者姓名、邮箱、职位等字段要用标准 itemprop 名，且注意值的提取规则
itemprop 的值不是“渲染后看到的文字”，而是由元素类型和属性共同决定的机器可读值。写错会导致 Google 提取到空值、乱码或拒绝收录。
- 姓名用
itemprop="name"，放在纯文本容器里（如<span itemprop="name">张三</span>）；避免含 HTML 标签，否则可能提取出"张三<sup>®</sup>" - 邮箱必须用
@#@#@#@#@#@#@#@#@#@0，仅写文本不会被识别为 email 类型 - 职位（jobTitle）、所在组织（worksFor）等属性必须存在对应
itemtype，例如worksFor的值应是另一个itemscope itemtype="https://schema.org/Organization" - 隐藏字段可用
<meta itemprop="sameAs" content="https://github.com/zhangsan">，但必须放在itemscope容器内
address 标签不是必须的，但搭配 itemscope 更易通过验证
HTML 原生 <address></address> 标签语义上就表示“联系人信息”，对屏幕阅读器和基础爬虫友好；但它本身不携带结构化类型。要让 Google 明确认出这是“作者”，必须叠加 itemscope itemtype="https://schema.org/Person"。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
常见误区是以为用了 <address></address> 就不用微数据，或者反过来只加微数据却忽略语义标签。两者结合才是健壮写法：
<address itemscope itemtype="https://schema.org/Person"> <span itemprop="name">李四</span>， <a itemprop="email" href="mailto:li4@example.com">li4@example.com</a> <time itemprop="jobTitle" datetime="Editor">编辑</time> </address>
注意：<address></address> 是块级元素，支持换行和内联标签，但不能嵌套 <h2></h2> 或 <p></p> —— 这会破坏其单主体语义。
最容易被忽略的是 itemtype URL 的可访问性：即使写对了 https://schema.org/Person，如果网络环境无法访问该地址（比如某些内网环境屏蔽了 schema.org），Google 工具仍可能报“无法解析类型”。上线前务必用 curl -I https://schema.org/Person 确认返回 200。
