Example Archives

Small, canonical .mdz files that validate cleanly. Use them as templates (especially if you're an automated producer — see the AI Producer Guide), as fixtures for testing an implementation, or just to poke at the format: rename any of them to .zip and look inside.

Minimal

The smallest useful conforming archive: index.md plus a manifest.

Download minimal.mdz · open in the web editor

With images

One document, one packaged image, referenced with an ordinary relative path (assets/mark.svg). Demonstrates the core promise: the reference can never break, because the image travels inside the file.

Download with-images.mdz · open in the web editor

Project mode

Multiple documents in one archive (mode: "project"), with an explicit entryPoint and documents cross-linking by relative path.

Download project.mdz · open in the web editor

Validate them yourself

mdz validate minimal.mdz

Every archive on this page passes validation without warnings — that's the bar for a conforming producer. See Using the mdz CLI for the tooling.

This page renders from examples.mdz — one self-contained file. Download it, open it in the web editor, or read how these pages are made.