anything-to-html

将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。

下载

itemtype必须与itemscope成对使用才能声明结构化数据类型，单独使用无效；review类型必需author、reviewbody、datepublished三属性，且author须为person/organization嵌套；评分需通过reviewrating关联独立rating实体。

itemtype 必须配合 itemscope 使用才生效

单独写 itemtype 没有意义，浏览器不会识别。它必须和 itemscope 成对出现，才能声明一个结构化数据块的类型。常见错误是只加 itemtype 却漏掉 itemscope，导致 Google Rich Results Test 工具完全不解析评价内容。

用户评价的标准 Schema.org 类型是 https://schema.org/Review，不是 Rating 或 AggregateRating —— 后两者分别表示单个评分值、多个评分汇总，不能替代一条完整评价。

• <div itemscope itemtype="https://schema.org/Review"> ✅ 正确起点<li><code><div itemtype="https://schema.org/Review"> ❌ 无 itemscope，无效<li><code><div itemscope itemtype="Review"> ❌ 缺少完整 URL，不被识别<h3>必需属性：author、reviewBody、datePublished</h3> <p>Google 对富媒体搜索结果中的评价有最低字段要求。<code>author、reviewBody、datePublished 是 Review 类型的强制属性，缺一不可，否则可能无法触发星级展示。

  注意 author 必须是嵌套的 Person 或 Organization 类型，不能直接写字符串：

  <div itemscope itemtype="https://schema.org/Review">
    <div itemprop="author" itemscope itemtype="https://schema.org/Person">
      <span itemprop="name">张三</span>
    </div>
    <div itemprop="reviewBody">产品做工扎实，发货很快。</div>
    <time itemprop="datePublished" datetime="2024-05-12">2024年5月12日</time>
  </div>

  • reviewBody 必须是纯文本或带语义的内联元素（如 <p></p>），避免套用 <div> 再加 <code>itemprop
  • datePublished 的 datetime 值需为 ISO 8601 格式（如 2024-05-12），显示文本可本地化
  • 如果评价来自匿名用户，author 仍需存在，可用 <meta itemprop="name" content="匿名用户">

  评分相关：ratingValue 要嵌套在 Rating 类型里

  用户打的分（比如 4.5 星）不能直接挂到 Review 上，必须用 reviewRating 属性关联一个独立的 Rating 实体。

  常见错误是把 ratingValue 当成 Review 的直系属性写错位置：

  <div itemscope itemtype="https://schema.org/Review">
    <!-- ... author, reviewBody, datePublished -->
    <div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
      <meta itemprop="ratingValue" content="4.5">
  <meta itemprop="bestRating" content="5">
  </div>
  </div>

  • reviewRating 是 Review 的属性，指向一个 Rating 类型节点
  • ratingValue 必须是数字字符串（如 "4.5"），不能带单位或文字
  • bestRating 和 worstRating 推荐显式声明，否则默认按 5 分制推断，但某些平台（如 Bing）可能更严格

  避免 itemid 滥用和嵌套污染

  除非你明确需要去重或跨页面引用同一条评价，否则不要加 itemid。加了反而可能让搜索引擎误判为重复内容。

  另一个高频陷阱是把多个 Review 块塞进同一个 itemscope 容器里，造成嵌套混乱。每个评价必须是独立的 itemscope 节点：

  • ✅ 正确：每个 <div itemscope itemtype="https://schema.org/Review"> 自成一体<li>❌ 错误：<code><div itemscope> <div itemtype="..."></div> <div itemtype="..."></div> </div> —— 外层无 itemtype，内层失去上下文
  • ⚠️ 注意：若页面同时有商品信息（Product）和其下的评价，Review 应通过 review 属性挂在 Product 下，而不是平级并列

  实际部署前，务必用 Google 的 Rich Results Test 验证，重点看 “Missing field” 提示 —— 那些往往就是漏掉 itemscope 或嵌套错层的地方。