JSON-LD article 标记怎么写:字段详解与完整代码示例 — 答流 AIGeoFlow · GEO 实战指南

JSON-LD article 标记写在网页 <head> 内的 <script type="application/ld+"> 标签中,以 JSON 对象描述文章核心信息:@type 声明为 Article(或 BlogPosting、NewsArticle),再填写 headline、image、datePublished、dateModified、author、publisher 及 mainEntityOfPage 等字段。日期必须用 ISO 8601 格式,字段值需与页面可见内容一致,发布前用 Google 富结果测试工具校验即可生效。

基础结构与必填字段

JSON-LD article 标记的本质,是用一段机器可直接解析的 JSON 数据描述文章。写法分三步:第一步,在页面中插入 <script type="application/ld+"> 脚本标签;第二步,声明 @context 为 https://schema.org,@type 按内容类型选择 Article、NewsArticle 或 BlogPosting;第三步,逐项填写字段。Google 对文章富结果有硬性要求的字段包括:headline(标题,建议控制在 110 字符以内)、image(至少一张可被抓取的图片 URL,推荐 1200 像素宽以上)、datePublished 与 dateModified(必须使用 ISO 8601 格式,如 2025-06-01T08:00:00+08:00)、author(声明 @type 为 Person 或 Organization 并给出 name)、publisher(Organization 类型并附 logo 图片对象)。所有字段值必须与页面可见内容一致,否则会被判定为结构化数据违规。

完整代码示例与放置位置

以下是一段可直接复用的完整示例:

<script type="application/ld+"> { "@context": "https://schema.org", "@type": "Article", "mainEntityOfPage": {"@type": "WebPage", "@id": "https://example.com/post"}, "headline": "文章标题(建议 110 字符以内)", "image": "https://example.com/cover-1200.jpg", "datePublished": "2025-06-01T08:00:00+08:00", "dateModified": "2025-06-10T09:30:00+08:00", "author": {"@type": "Person", "name": "作者名"}, "publisher": { "@type": "Organization", "name": "站点名", "logo": {"@type": "ImageObject", "url": "https://example.com/logo.png"} } } </script>

放置位置上,这段脚本放在 head 或 body 任意位置均可被正常解析,一篇文章只保留一组标记;同一页面有多个结构化对象时,建议用 @graph 数组统一管理,避免重复声明。WordPress 站点可用插件自动输出,静态站直接写入文章模板即可。

常见错误与校验方法

写完不等于写对。高频错误包括:日期未用 ISO 8601 格式导致解析失败;headline 与页面 H1 不一致;image 地址返回 403 或重定向;author 只写了一个字符串而未声明 @type;publisher 缺少合规 logo。校验只需两个官方工具:Google 富结果测试(Rich Results Test)检查文章富结果资格与警告,Schema Markup Validator 检查语法合法性。还需明确一点:JSON-LD 只解决机器可读问题,不保证被 AI 引擎推荐——这也是答流 AIGeoFlow 的原则,不承诺保证被 AI 推荐,只承诺可验证的硬指标,包括 AI 爬虫来访记录、每周引用实测存档与转化归因三层数据。若不想改动主站模板,也可通过 Cloudflare Worker 在边缘注入标记,主站一行代码不动,域名权重全保留。

常见问题

JSON-LD article 标记必须放在 head 里吗?
不必须。JSON-LD 脚本可以放在 head 或 body 的任意位置,Google 和主流 AI 爬虫都能正常解析。放在 head 更常见,便于统一管理与排查;若担心影响首屏加载,放在 body 末尾同样有效。
@type 应该用 Article、BlogPosting 还是 NewsArticle?
三者是 schema.org 中的继承关系,BlogPosting 和 NewsArticle 都是 Article 的子类型。普通博客文章用 BlogPosting,新闻报道用 NewsArticle,通用场景直接用 Article 即可。选错子类型影响不大,把字段写完整、值写准确才是关键。
加了 JSON-LD 标记,AI 搜索引擎就一定会引用我的文章吗?
不一定。结构化数据解决的是机器可读性与内容理解准确度,是被 AI 检索的基础,但最终是否被引用还取决于内容质量与相关性。答流 AIGeoFlow 不承诺保证被 AI 推荐,只承诺可验证的硬指标:AI 爬虫来访记录、每周引用实测存档与转化归因,覆盖 ChatGPT、Perplexity、Gemini、豆包、Kimi、DeepSeek 等国内外引擎。
如何验证 article 标记是否正确生效?
第一步用 Google 富结果测试输入页面网址,查看 Article 卡片是否被识别、有无错误与警告;第二步用 Schema Markup Validator 校验 JSON 语法。上线后可在 Google Search Console 的增强功能报告中持续监测收录与错误情况,发现问题及时修复。答流 AIGeoFlow 也提供技术就绪度与内容就绪度双维度免费诊断,即时生成 0-100 评分与改进清单。
免费测一测:AI 能找到你的网站吗?

相关阅读