Open standardgoverned by the bitmark Association

Meet bitmark: the open, AI-native format for knowledge

Knowledge as semantic chunks: typed, addressable bits, linked into a graph, that people and AI read the same way.

Open in playground ↗

bitmark

[.smart-standard-article-normative]
[@customerId: p_4_1 ]
[customer▼ p_4_1 ]
The rated values are given in (+customer ref:tab_1)Table 1(-customer ref).

JSON

{
  "type": "smart-standard-article-normative",
  "format": "bitmark++",
  "bitLevel": 1,
  "customerId": "p_4_1",
  "customerAnchor": "p_4_1",
  "body": [
    {
      "type": "paragraph",
      "content": [
        {
          "text": "The rated values are given in ",
          "type": "text"
        },
        {
          "text": "Table 1",
          "type": "text",
          "marks": [
            {
              "type": "customerRef",
              "attrs": {
                "customerRef": "tab_1"
              }
            }
          ]
        },
        {
          "text": ".",
          "type": "text"
        }
      ]
    }
  ]
}

JSONL

{"bit":{"type":"smart-standard-article-normative","format":"bitmark++","bitLevel":1,"customerId":"p_4_1","customerAnchor":"p_4_1","body":[{"type":"paragraph","content":[{"text":"The rated values are given in ","type":"text"},{"text":"Table 1","type":"text","marks":[{"type":"customerRef","attrs":{"customerRef":"tab_1"}}]},{"text":".","type":"text"}]}]}}

JSONL + Passport · Proposal

{"passport":{"@context":["https://schema.org"],"publisher":"Example Publisher","license":"https://creativecommons.org/licenses/by/4.0/","inLanguage":"en","conformsTo":"EPUB Accessibility 1.1 - WCAG 2.2 Level AA","aiUse":{"retrieve":true,"train":false}}}
{"bit":{"type":"smart-standard-article-normative","format":"bitmark++","bitLevel":1,"customerId":"p_4_1","customerAnchor":"p_4_1","body":[{"type":"paragraph","content":[{"text":"The rated values are given in ","type":"text"},{"text":"Table 1","type":"text","marks":[{"type":"customerRef","attrs":{"customerRef":"tab_1"}}]},{"text":".","type":"text"}]}],"hash":"9f3c…","lastModified":"2026-11-01T09:30:00Z"}}
Passport · Proposal Licence CC BY 4.0 AI use retrieve ✓ · train ✗ Access WCAG 2.2 AA Hash 9f3c…

A normative provision with the customer’s own ID and a link to their table.

Get started

npm i @gmb/bitmark-parser
Get the parser API documentation npm ↗

Built for

Why bitmark →

Roadmap

Next for bitmark: the bit passport, one header that carries rights, AI use and accessibility for every bit in a delivery.

Proposed

  • The bit passport Proposal one header for rights, AI use and accessibility of every bit in a delivery
  • Versions and updates Proposal a hash and a date per bit, so readers refetch only what changed

In the parser today

  • Toggle tags styles switched on and off inside the text
  • JSONL one bit per line, the format for APIs and agents
  • The Rosetta Map NISO STS import that keeps every ID, anchor and link
  • Alias and diff books the same content under other properties, or only what changes

Planned

The roadmap →

Where bitmark sits on the SMART levels

Five levels of digital standards. Level 3, granular units with unique IDs and their links, is marked bitmark today; Level 4, machine-interpretable content, is marked in progress. A conversion service lifts PDF and scans from Level 1 to Level 3; the Rosetta Map brings XML at Level 2 into bitmark at Level 3 with its IDs.

Explore the language

Working groups

Twelve groups shape the standard: rights, accessibility, norms, legal texts, science, learning and more. Anyone can take part.

Join a working group ↗