JSON-LD 教程
JSON-LD 是一种基于 JSON 的链接数据格式。它让数据保持 JSON 的可读性，同时通过 @context、@id、@type 等约定说明字段含义、实体身份和实体关系。
本教程面向前端开发、内容站点、SEO、知识图谱和 API 设计场景。你将从一个能直接放进 HTML 的示例开始，逐步理解上下文、IRI、Schema.org、验证流程和生产维护方式。
你会学到什么
| 模块 | 重点 |
|---|---|
| 基础入门 | JSON-LD 与普通 JSON、RDF、结构化数据之间的关系 |
| 语法模型 | @context、@type、@id、@value、@graph 等核心关键字 |
| Web 应用 | 在 HTML 中嵌入 application/ld+json，为搜索引擎和消费方提供结构化信息 |
| 生产实践 | 数据与页面一致性、稳定 ID、远程上下文、验证和排错 |
| 参考资料 | 常用关键字、Schema.org 类型、Google Search 富媒体结果注意事项 |
第一个示例
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "JSON-LD 入门指南",
"datePublished": "2026-09-22",
"author": {
"@type": "Person",
"name": "Ada Chen"
}
}
</script>
这段数据不会改变页面视觉内容，但机器可以据此知道：页面描述的是一篇文章，文章有标题、发布时间和作者。
学习路线
- 先阅读 JSON-LD 简介，理解它解决的问题。
- 跟着 快速开始 把结构化数据放到页面中。
- 通过 语法基础 和 上下文与词汇表 掌握核心模型。
- 如果目标是搜索展示，重点阅读 Schema.org 与 SEO。
- 上线前使用 最佳实践 和 常见问题排查 做检查。
参考资料
- W3C JSON-LD 1.1 Recommendation
- JSON-LD.org
- JSON-LD Playground
- Schema.org
- Google Search Central: 结构化数据简介
相关内容
- JSON-LD 进阶用法 介绍 @graph、实体复用、反向属性、语言映射、索引映射、远程上下文和 API 设计等 JSON-LD 进阶实践。
- JSON-LD 最佳实践 汇总 JSON-LD 在网页、API、结构化数据和知识图谱中的生产建议，覆盖数据一致性、ID 设计、上下文治理和验证流程。
- JSON-LD 上下文与词汇表 深入理解 @context 的作用、远程上下文、本地上下文、@vocab、前缀映射和字段别名，掌握 JSON-LD 语义映射方式。
- JSON-LD 快速开始 通过一个可直接嵌入 HTML 页面的 Article 示例，学习 JSON-LD 的编写、放置、验证和迭代流程。
- JSON-LD 简介 介绍 JSON-LD 的定位、适用场景、与普通 JSON 和 RDF 的关系，以及它在网页结构化数据和开放数据中的价值。
- Schema.org 与 SEO 说明如何用 JSON-LD 编写 Schema.org 结构化数据，理解 Google 搜索支持范围、富媒体结果资格和页面内容一致性要求。