Skip to main content
Linked Markdown is a specification for Markdown documents with semantic frontmatter. It lets ordinary Markdown pages carry typed JSON-LD-style attributes that can be validated, queried, and loaded into RDF tooling.

​
Example

---
{
  "@id": "https://example.org/docs/ethan-davidson",
  "@type": "schema:Person",
  "@context": {
    "schema": "https://schema.org/"
  },
  "schema:givenName": "Ethan",
  "schema:familyName": "Davidson"
}
---

# Ethan Davidson

Ethan Davidson is a [knowledge graph engineer](./roles/knowledge-graph-engineer.md).

​
What it unlocks

  • Markdown that remains pleasant for humans to write.
  • Frontmatter that machines can interpret as semantic data.
  • Compatibility with JSON-LD, RDFLib, and RDF graph workflows.
  • Shared conformance tests across language implementations.

​
Repositories

RepositoryPurpose
linked-markdownSpecification, paper, conformance suite, and community materials
linked-markdown-tsTypeScript implementation published on JSR
linked-markdown-pyPython implementation published on PyPI

​
Install

pip install linked-markdown

deno add jsr:@wazoo/linked-markdown

npx jsr add @wazoo/linked-markdown