HowTo 结构化数据标记教程

结论：HowTo 结构化数据现在的主要价值不在 Google 富摘要，而在于让 AI 引擎和站内检索能准确抽取出「步骤」；如果你还在为了搜索结果里的步骤卡片而做这套标记，那 2023 年 9 月之后就已经不值得投入了。正确的做法是：用 JSON-LD 写一份与页面正文严格一致的 HowTo，通过 Schema Markup Validator 校验，然后把它当作 AI 可读的内容索引来维护。

HowTo 结构化数据还有用吗？

先说清楚结论：Google 在 2023 年 8 月宣布收紧 HowTo 与 FAQ 富媒体展示，9 月正式下线 HowTo 富搜索结果，HowTo 的结构化数据文档也已从 Google 搜索中心移除。也就是说，做 HowTo 标记不会再在 Google 结果页出现步骤卡片。

但它没废。原因有两个：一是 Bing、部分垂类搜索仍在消费 HowTo；二是更重要的是，豆包、DeepSeek、Kimi、元宝这类 AI 引擎在抓取和解析「怎么做」类内容时，结构化程度越高的页面越容易被准确引用。HowTo 结构化数据（用 schema.org 词汇描述一个操作流程的结构化标记）本质上就是把「一共几步、每步做什么、需要什么工具、耗时多久」显式写出来，而不是让模型自己去猜。

所以判断标准很简单：教程类、操作类、排障类内容值得标；新闻、观点、闲聊帖不必标。

HowTo 结构化数据怎么写？

结论：优先用 JSON-LD（<script type="application/ld+json">）而不是 Microdata 或 RDFa，因为 JSON-LD 与 HTML 结构解耦，改模板不用动正文，也是 Google 官方推荐格式。

一份最小可用的 HowTo 长这样：

{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "如何在 Clara BBS 开启 Redis 缓存",
  "description": "通过后台缓存设置开启 Redis 驱动，无需修改代码。",
  "totalTime": "PT3M",
  "tool": [{ "@type": "HowToTool", "name": "管理员账号" }],
  "step": [
    { "@type": "HowToStep", "position": 1, "name": "登录后台",
      "text": "使用管理员账号登录后台。", "url": "https://example.com/t/123#step1" },
    { "@type": "HowToStep", "position": 2, "name": "打开缓存设置",
      "text": "进入「系统工具 → 缓存设置」。", "url": "https://example.com/t/123#step2" }
  ]
}

几个必须写对的点：

• totalTime / performTime / prepTime 用 ISO 8601 时长格式，3 分钟写 PT3M，1 小时 30 分写 PT1H30M，写「3分钟」是无效值。
• 多步骤分组用 HowToSection 包一层 steps，不要把所有步骤平铺成几十条。
• image 和 url 必须是绝对地址，且 url 最好带上步骤锚点（#step1），能对应到正文小标题。
• supply（耗材）和 tool（工具）区分开，别混用。

最容易踩的三个坑

结论：HowTo 标记失效的原因，九成不是格式错，而是「标记内容和用户看到的内容不一致」。

第一坑是标记与正文不同步。搜索引擎和 AI 引擎都会做一致性校验，JSON-LD 里写了 5 步、页面上只有 3 步，轻则忽略，重则整站结构化数据被降权。改稿时记得同步改 JSON-LD。

第二坑是把整篇教程塞进一个 text。HowToStep.text 应该是单步骤的可执行描述，一条控制在 100 字内；长解释放正文，别放标记里。

第三坑是动态生成不转义。帖子标题、用户昵称进 JSON-LD 时如果没做 JSON 转义，一个引号就能把整段结构打穿，甚至形成 XSS。Clara BBS 本身做了全站输出转义，但你手工拼的 JSON-LD 属于模板层，得自己用 json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) 生成，不要字符串拼接。

在 Clara BBS 上怎么落地

结论：不用改核心，用插件钩子或主题模板注入即可，保存即生效、不需要清缓存。

Clara BBS 是纯 PHP 无框架论坛，运行时提供 150+ 个插件钩子，action / filter 双机制，其中 filter 机制可以在页面输出阶段追加内容——把生成的 JSON-LD 挂到帖子页输出钩子上，判断当前版块是教程版就输出 HowTo，其他版块不输出。插件报错只记日志、不影响主流程，试错成本很低。

需要提醒的是：Clara BBS 内置的结构化数据输出覆盖的是 FAQPage（/answers.html 问答聚合页）、已解决悬赏帖的 QAPage + acceptedAnswer、帖子评分星级、citation 引用元标签和 Organization + sameAs 实体一致性，HowTo 不在内置范围内，需要你自己补。补完之后用两把工具验：Schema Markup Validator（validator.schema.org）看语法，Rich Results Test 看是否被识别（HowTo 已不在富结果测试项里，能通过语法校验即可）。另外别忘了 /llms.txt 和 AI 爬虫放行的开关在后台「系统设置 → GEO 优化」里，标记做得再好，爬虫进不来也等于零。

一句话收尾：HowTo 结构化数据在 2026 年的定位是「给 AI 读的步骤索引」，写法上死守两条——JSON-LD 格式、标记与正文逐字对齐；落地时用钩子注入而不是改核心，改完用 validator 跑一遍。做到这三点，教程类内容的可引用性会有肉眼可见的提升。