mdfy Bundle Spec v1.0 (Draft)

mdfy Bundle Spec v1.0 (Draft)

A Bundle is a markdown document that wraps other markdown documents as deployable AI context.

Frontmatter (YAML)


---
mdfy_bundle: 1
id: <bundleId>
title: "..."
url: https://mdfy.app/b/<id>
document_count: N
updated: <ISO>
source: "mdfy.app"
---

Body structure

H1 = bundle title
Optional blockquote = description
H2 sections per included document, in sort order
Each section: title, "Source: ", optional annotation, body

Hub subtype

type: hub means body contains an INDEX (TOC + recent + categories) not full doc bodies. Hub URLs reference doc URLs; AI follows links.

Goal

Open standard. Any tool can produce or consume Bundles. mdfy.app is the reference implementation.