MDX

Entstanden 2018 aus einem konkreten Problem: Doku-Websites wollten den Schreibkomfort von Markdown, brauchten aber auch interaktive Demos, Diagramme und Tabs mitten im Text — und die Lösung davor war immer eine projekteigene Shortcode-Syntax. MDX machte stattdessen JSX zum vollwertigen Bestandteil des Dokuments: import oben, Komponenten mitten zwischen den Absätzen.

Version 2 (2021) schrieb den Parser auf micromark um und ergänzte Ausdrücke in geschweiften Klammern, was das Format deutlich berechenbarer machte. Es treibt die Dokumentation eines großen Teils des JavaScript-Ökosystems an: Next.js, Docusaurus, Astro und Storybook. Der Preis: Eine .mdx-Datei ist kein reiner Text mehr — sie braucht einen Build-Schritt und eine Komponentenbibliothek, um überhaupt etwas zu bedeuten.