# 💻 MDKV: A Multitrack Markdown Container for Structured, Portable Documents

**Daniel Ari Friedman** (2025) · *Zenodo*

[![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.16790554-blue)](https://doi.org/10.5281/zenodo.16790554)

---
<!-- Schema.org structured data for search engines -->
<!--
{"@context":"https://schema.org","@type":"ScholarlyArticle","headline":"MDKV","abstract":"MDKV (Markdown Key-Value) is a lightweight, YAML-free key-value format for Markdown documents. Every key-value pair maps to a Markdown heading and its body text, enabling round-trip transformations between human-readable Markdown documents and structured data (JSON, TOML). The specification is open source under Apache-2.0 and situates MDKV with respect to Matroska (MKV) for extensible container design.","keywords":["MDKV","Markdown","key-value format","structured data","document specification","YAML-free","round-trip transformation"],"author":{"@type":"Person","name":"Daniel Ari Friedman","url":"https://danielarifriedman.com/"}}
-->


## Abstract

> This paper introduces MDKV, a multitrack Markdown container designed to manage multilingual, multi-audience, and multi-channel documents by packaging canonical content and auxiliary tracks into a single, portable .mdkv file. The MDKV format enhances document governance, reproducibility, and editing efficiency by separating concerns into distinct tracks.

## Keywords

`MDKV` · `Markdown` · `key-value format` · `structured data` · `document specification` · `YAML-free` · `round-trip transformation`

## Key Contributions

- A precise model and container format with minimal but sufficient validation.
- A modular architecture separating model, storage, and services, accessible via CLI and GUI.
- Detailed use cases for multilingual publishing, layered collaboration, and reproducible distribution.
- Guidance for cryptographic provenance and conformance.

## Methods

- Introduced a ZIP archive format containing a YAML manifest and UTF-8 Markdown files.
- Formalized the MDKV model and presented its software architecture.
- Evaluated design trade-offs against adjacent technologies.
- Provided a CLI and a small GUI for selective preview and live editing.

## 🎯 Consulting & Tutoring

**Available for AI Research Consulting and Tutoring.** [Contact Daniel Ari Friedman, PhD](https://danielarifriedman.com/) for collaboration on Active Inference, Bayesian modeling, and computational biology.

## Citation

```bibtex
@article{2025_MDKV,
  author = {Daniel Ari Friedman},
  title = {{MDKV: A Multitrack Markdown Container for Structured, Portable Documents}},
  journal = {Zenodo},
  year = {2025},
  doi = {10.5281/zenodo.16790554},
}
```

## File Inventory

- `AGENTS.md` (1,901 bytes)
- `2025_MDKV.pdf` (147,448 bytes)
- `README.md` (1,567 bytes)
- `SKILL.md` (1,708 bytes)