Linked Markdown

A specification for structuring, validating, and querying typed Markdown documents as first-class semantic graph nodes.

• spec/ — The LMD specification (W3C JSON-LD CG work item)
• conformance/ — Shared language-agnostic conformance test suite
• paper/ — "LMD: Linked Markdown — Markdown as Semantic Infrastructure"
• community/ — W3C Community Group introduction materials
• TypeScript implementation — @wazoo/linked-markdown on JSR
• Python implementation — linked-markdown on PyPI

Installation

# Python
pip install linked-markdown

# TypeScript (Deno)
deno add jsr:@wazoo/linked-markdown

# TypeScript (Node)
npx jsr add @wazoo/linked-markdown

RDF Compatibility

The attrs returned by extract() is valid JSON-LD, directly loadable into the standard RDF library of your choice:

Python — uses rdflib:

import json
import rdflib
from linked_markdown import extract

result = extract(markdown)
g = rdflib.Graph()
g.parse(data=json.dumps(result.attrs), format="json-ld")

TypeScript — uses jsonld:

import jsonld from "jsonld";
import { extract } from "@wazoo/linked-markdown";

const result = extract(markdown);
const quads = await jsonld.toRDF(result.attrs);