For the complete documentation index, see llms.txt. This page is also available as Markdown.

Data from JSON

The .json {path} ^{docs ↗} function loads a JSON file and returns its content ready to use in your document.

The path parameter can be either a path relative to the main source file’s location or an absolute path. Use a slash (/) as the path separator, regardless of the operating system.

The shape of the returned value depends on the top-level JSON value:

• A JSON object is loaded as a dictionary, which you can query with .get.
• A JSON array is loaded as an iterable, which you can iterate with .foreach or manipulate with any iterable operation.

.code {json}
    .read {assets/config.json}

.json {assets/config.json}::get {database}::get {host}

{
  "name": "Quarkdown",
  "database": {
    "host": "localhost",
    "port": 5432
  },
  "features": ["math", "diagrams", "footnotes"]
}

.code {json}
    .read {assets/people.json}

.json {assets/people.json}::foreach
    **.1::get {name}** is from .1::get {address}::get {country}

[
  {"name": "Alice", "address": {"country": "USA"}},
  {"name": "Bob", "address": {"country": "Italy"}},
  {"name": "Carol", "address": {"country": "Japan"}}
]