> ## 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.

# Vault-LD

> Linked Markdown vs Vault-LD: portable RDF-in-markdown specs compared.

## At a glance

|                | Linked Markdown (Wazoo)                                                                                                                          | [Vault-LD](https://github.com/The-Knowledge-Graph-Guys/vault-ld) (The-Knowledge-Graph-Guys) |
| :------------- | :----------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------ |
| Core focus     | Formal W3C specification, multi-lang Extract API, & toolchain                                                                                    | Open specification & round-trip parser concept                                              |
| Frontmatter    | Standard JSON-LD / YAML-LD frontmatter                                                                                                           | YAML-LD (JSON-LD serialized as YAML) with `@context`                                        |
| Reference SDKs | PyPI ([`linked-markdown`](https://pypi.org/project/linked-markdown/)) & JSR ([`@wazoo/linked-markdown`](https://jsr.io/@wazoo/linked-markdown/)) | Reference specification repo                                                                |
| Ecosystem      | Integrated with [`wiki`](/projects/wiki), [`Worlds`](/projects/worlds), and [`memsdk`](/projects/memsdk)                                         | Standalone note vault specification                                                         |
| Publications   | Published W3C CG Editor's Draft & [Zenodo DOI paper](https://zenodo.org/records/21216085)                                                        | Open specification (`SPEC.md`)                                                              |

## The convergence of Linked Markdown and Vault-LD

Both [Linked Markdown](/projects/linked-markdown) (by Wazoo) and
[Vault-LD](https://github.com/The-Knowledge-Graph-Guys/vault-ld) (by
[The Knowledge Graph Guys](https://www.knowledge-graph-guys.com/)) arrived at
the same realization: standard CommonMark files with valid W3C JSON-LD / YAML-LD
frontmatter are the open primitive for semantic Markdown and agent knowledge
graphs.

Because both specifications converged on zero nonstandard syntax and native
JSON-LD semantics, an LMD document and a Vault-LD document accept the exact same
document structure. A single `.md` file functions simultaneously as
human-readable prose and a valid RDF graph node in both ecosystems.

```markdown theme={null}
---
"@id": "https://wazoo.dev/team/Ethan_Davidson"
"@type": "Person"
"@context":
  "@vocab": "http://schema.org/"
givenName: "Ethan"
familyName: "Davidson"
---

# Ethan Davidson

Ethan leads engineering and product on Wazoo/Worlds.
```

The distinction is toolchain maturity and real-world deployment, not document
format:

* Linked Markdown (LMD) is backed by production-grade tooling: official
  multi-language Extract APIs (`linked-markdown-py` on PyPI,
  `@wazoo/linked-markdown` on JSR), a formal W3C Community Group Editor's Draft,
  a published research paper (Zenodo DOI: `10.5281/zenodo.21216085`), and a
  complete CLI toolchain (`wiki`, Wazoopedia, `memsdk`, and Wazoo Worlds).
* Vault-LD is an open specification (`SPEC.md`) for lossless round-trip parsing
  in personal knowledge bases.

## Why choose Linked Markdown

* Ready-to-install packages for Python
  ([`pip install linked-markdown`](https://pypi.org/project/linked-markdown/))
  and TypeScript
  ([`jsr:@wazoo/linked-markdown`](https://jsr.io/@wazoo/linked-markdown)) with
  deterministic
  [`extract()`](https://jsr.io/@wazoo/linked-markdown/doc/~/extract) APIs that
  convert markdown directly to RDF quads and JSON-LD nodes.
* A formal W3C JSON-LD Community Group specification and a published DOI paper
  on semantic Markdown infrastructure.
* Native integration with the `wiki` CLI (linting, SHACL shape validation,
  SPARQL querying, and static site rendering) and Wazoo Worlds context engines.

## Interoperability

Because Linked Markdown and Vault-LD converged on the exact same underlying RDF
1.1 data model and JSON-LD semantics, they are 100% interoperable. Any Vault-LD
document can be extracted, validated, and queried with
[`linked-markdown`](/projects/linked-markdown) SDKs or the
[`wiki`](/projects/wiki) CLI toolchain.