Metadata Conventions

JSONHTL allows any top-level keys alongside content. This document defines the conventional metadata keys used in this system.

Standard Keys

title (string) — human-readable title for the document.

version (integer) — version number for the document. An LLM or tool that remembers the version it last read can skip re-reading unchanged documents.

created (string, ISO date) — date the document was created.

updated (string, ISO date) — date the document was last modified.

tags (list of strings) — freeform tags for categorisation and search.

Unknown Keys

Per the JSONHTL spec, consumers should ignore any top-level keys they do not recognise. New metadata keys may be introduced by adding them to this document.