> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wazoo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Linked Markdown

> Linked Markdown structures Markdown documents as semantic graph nodes.

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

```md theme={null}
---
{
  "@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

| Repository                                                            | Purpose                                                          |
| --------------------------------------------------------------------- | ---------------------------------------------------------------- |
| [linked-markdown](https://github.com/wazootech/linked-markdown)       | Specification, paper, conformance suite, and community materials |
| [linked-markdown-ts](https://github.com/wazootech/linked-markdown-ts) | TypeScript implementation published on JSR                       |
| [linked-markdown-py](https://github.com/wazootech/linked-markdown-py) | Python implementation published on PyPI                          |

## Install

<CodeGroup>
  ```bash Python theme={null}
  pip install linked-markdown
  ```

  ```bash Deno theme={null}
  deno add jsr:@wazoo/linked-markdown
  ```

  ```bash npm theme={null}
  npx jsr add @wazoo/linked-markdown
  ```
</CodeGroup>