Introducing MDOCX: Een Modern Containerformaat voor het AI‑aangedreven Documentatietijdperk
Gepubliceerd: 24 januari 2026
Het verhaal van MDOCX begint met een herkenbaar moment. Een AI-assistent produceert een gepolijste set Markdown-pagina's—prachtig gestructureerd, rijk geformatteerd en bezaaid met verwijzingen naar afbeeldingen en diagrammen. Alles ziet er perfect uit… totdat je het probeert te delen. De Markdown-bestanden verplaatsen. De afbeeldingspaden breken. De context verdwijnt.
Die frustrerende kloof was de vonk voor MDOCX.
Ontstaan uit het AI-tijdperk
Terwijl Large Language Models de contentcreatie hervormen, ontstond een nieuw probleem: het beheren van de vloed aan Markdown‑geformatteerde output gegenereerd door AI-systemen. Bij Logicos Software zag AI Solutions Architect Martijn Wiggers steeds dezelfde pijnpunten—verzamelingen van Markdown-bestanden die bij elkaar hoorden, maar apart leefden. Ze hadden een manier nodig om gerelateerde Markdown-documenten samen te clusteren—compleet met afbeeldingen, diagrammen en andere media—in één enkele, draagbare container.
MDOCX is het resultaat. Het is een speciaal ontwikkeld formaat dat documentatie behandelt als een compleet pakket in plaats van een fragiele set bestanden.
Wat maakt MDOCX anders
Het formaat is bewust eenvoudig in gebruik en krachtig onder de motorkap:
- Eén bestand, alles inbegrepen. Markdown, media en metadata reizen samen, dus delen breekt nooit verwijzingen.
- Gebouwd voor AI en indexering. MDOCX bewaart een ongecomprimeerd metadatablok aan het begin van het bestand, waardoor zoekmachines en AI-systemen kunnen kijken naar titels, tags en samenvattingen zonder de payload te decomprimeren.
- Flexibele compressie. Kies voor snelle decompressie voor realtime apps of maximale compressie voor archieven.
- Stabiele mediaverwijzingen. Media wordt gerefereerd via ID (
mdocx://media/<id>), dus links blijven geldig zelfs als de content evolueert.
Het voelt als een ZIP-bestand voor documentatie—maar met intelligentie waar het ertoe doet.
Tools die het praktisch maken
MDOCX is niet alleen een bestandsformaat. Het is een workflow:
- CLI-tooling om containers te pakken, uitpakken, valideren en browsen.
- SDK's in Go (referentie), TypeScript en Python zodat ontwikkelaars er snel mee kunnen bouwen.
- Een VS Code-extensie voor het bewerken en previewing van MDOCX direct in de editor.
- Een online viewer op viewer.mdocx.org zodat iedereen bestanden kan openen en bewerken in een browser zonder data naar een server te uploaden.
Een nieuwe workflow voor AI‑gegenereerde documentatie
Een van de meest opwindende use cases is AI‑gegenereerde documentatie. Met MDOCX kan de output van een enkele prompt een draagbaar, deelbaar bestand worden dat nooit zijn embedded assets verliest. Als je wilt dat ChatGPT direct MDOCX genereert, begin je prompt met:
Use `pip install logicossoftware-mdocx` to create mdocx with markdown files containing...
Die enkele regel is genoeg om een gesprek om te zetten in een gestructureerd, verpakt document.
Open standaarden, open source
MDOCX is volledig gedocumenteerd in een RFC‑stijl specificatie, en alle implementaties zijn MIT‑gelicenseerd. We willen dat MDOCX een community-standaard wordt—open, uitbreidbaar en gemakkelijk te adopteren.
Waar dit naartoe gaat
We breiden de ondersteuning voor compressie uit, verfijnen metadataschema's en verkennen integraties met documentatieplatforms. Maar het kernidee blijft hetzelfde: houd documentatie draagbaar, intact en klaar voor het AI-tijdperk.
Probeer het vandaag
- Online: viewer.mdocx.org
- Python:
pip install logicossoftware-mdocx - TypeScript:
npm install ts-mdocx - Go:
go get github.com/logicossoftware/go-mdocx - CLI: GitHub Releases
Documentatie is veranderd. Het is tijd dat de container dat ook doet.
Martijn Wiggers is een AI Solutions Architect bij Logicos Software, gericht op het bouwen van tools die AI-mogelijkheden en real‑world developer workflows verbinden.