---
title: "mdfy Bundle Spec v1.0 (Draft)"
url: https://mdfy.app/ycd04NxU
updated: 2026-05-04T22:07:01.012Z
source: "mdfy.app"
---
# 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: <url>", 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.