json-ld.org

Introduction

This is the source for the https://json-ld.org/ website.

JSON-LD (JavaScript Object Notation for Linking Data) is a lightweight Linked Data format. It is easy for humans to read and write. It is easy for machines to parse and generate. It is based on the already successful JSON format and provides a way to help JSON data interoperate at Web-scale. If you are already familiar with JSON, writing JSON-LD is very easy. There is a smooth migration path from the JSON you use today, to the JSON-LD you will use in the future. These properties make JSON-LD an ideal Linked Data interchange language for JavaScript environments, Web services, and unstructured databases such as CouchDB and MongoDB.

If you are already using JSON-LD, add yourself to the list of users in our wiki.

A Simple Example

A simple example of a JSON object with added semantics::

{
  "@context": "https://json-ld.org/contexts/person.jsonld",
  "@id": "http://dbpedia.org/resource/John_Lennon",
  "name": "John Lennon",
  "born": "1940-10-09",
  "spouse": "http://dbpedia.org/resource/Cynthia_Lennon"
}

The example above describes a person whose name is John Lennon. The difference between regular JSON and JSON-LD is that the JSON-LD object above uniquely identifies itself on the Web and can be used, without introducing ambiguity, across every Web site, Web services and databases in operation today.

The Playground

If you would like to play around with JSON-LD markup, you may do so here:

https://json-ld.org/playground/

The Specifications

If you are a developer, you may be interested in the official JSON-LD W3C specifications:

• JSON-LD 1.1 - A JSON-based Serialization for Linked Data
• JSON-LD 1.1 Processing Algorithms and API
• JSON-LD 1.1 Framing

A list of all previous specification drafts is also available.

https://json-ld.org/spec/

Website Development

• This site is published using Eleventy.
• The site is deployed using Cloudflare Pages.
• The playground has a special proxy to handle http: URLs.

To develop this website locally:

# install dependencies
npm i
# to just build the static files to `_site/`
npm run build
# to rebuild the files on changes
npm run watch
# to serve `_site/` with Cloudflare Pages feature support
npm run pages # visit http://localhost:8788/

Additionally, if you want to use or test the playground http: proxy, also run the Wrangler server to emulate the Cloudflare Pages Functions code:

npm run dev