Skip to main content

​
Hello, MDA!

About these examples. The examples in this section illustrate material outside the v1.0 spec, including ai-script JSON blocks and pre-v1.0 frontmatter shapes. ai-script is out of v1.0 scope and v1.0 frontmatter places MDA-extended fields under metadata.mda.*, not at the top level. For v1.0-conformant authoring, start at Quickstart and the Specification.
This is a minimal MDA document. It looks like regular Markdown but includes three optional enhancements:
  1. Front Matter (above) — structured metadata in YAML
  2. AI Script (below) — processing instructions for LLMs
  3. Footnotes (bottom) — typed document relationships

​
Content

MDA extends Markdown without breaking it. Any Markdown renderer will display this file correctly. AI systems that understand MDA can additionally leverage the metadata, instructions, and relationships. 
{
  "script-id": "summarize-hello",
  "prompt": "Summarize this document in one sentence for a developer audience.",
  "priority": "low",
  "auto-run": false,
  "output-format": "markdown"
}

​
Learn More

See the full specification for details on each component1.

Footnotes

  1. {"rel-type": "parent", "doc-id": "MDA-SPEC-001", "rel-desc": "MDA Open Spec — full document"} ↩