Human-readable Data Formats

Markdown

Markdown ist heute Standard in Entwickler- und Wissenschaftskontexten. Z.B. Dokumentationen in Softwareprojekten (z. B. README.md auf GitHub oder GitLab), Formatierte Texte in Wikis, Foren oder Lernplattformen sowie Blogbeiträge und Online-Artikel mit einfacher Syntax.

Vorteile

  • Plattformunabhängig: funktioniert auf praktisch allen Betriebssystemen, Editoren und Plattformen (GitHub, GitLab, Jupyter, Obsidian, etc.).
  • Flexible Konvertierung: lässt sich über Tools wie Pandoc einfach in HTML, PDF, DOCX, ODT, LaTeX u. a. umwandeln.
  • Versionskontrolle: hervorragend geeignet für Git und andere Versionierungssysteme.
  • Fokus auf Inhalt statt Layout: fördert konzentriertes Schreiben, da Formatierung auf das Wesentliche reduziert ist.
  • Erweiterbar durch Dialekte: Varianten wie GitHub Flavored Markdown (GFM), CommonMarkoder Pandoc Markdownermöglichen zusätzliche Funktionen (Tabellen, Fußnoten, Formeln, Aufgabenlisten).

Nachteile

  • Uneinheitliche Standards: verschiedene Dialekte (z. B. GFM, MultiMarkdown) führen zu Inkompatibilitäten zwischen Plattformen.
  • Begrenzte Formatierungsmöglichkeiten: Formulare, komplexe Tabellen, Fußnoten, Zitate oder Literaturverzeichnisse sind nur über Erweiterungen oder Zusatztools möglich.
  • Keine native Unterstützung für interaktive Inhalte
  • Kann bei größeren Projekten unübersichtlich werden

YAML YAML Ain’t Markup Language

  • Syntaxbeispiele bei Wikipedia
  • Speziell entworfen für bessere Lesbarkeit im Mensch-Bearbeitungskontext.
  • Weit verbreitet bei Konfigurations­dateien (z. B. DevOps, Infrastruktur) und für Daten­austausch.
  • Vorteil: unterstützt Kommentare, saubere Einrückung, übersichtlichere Struktur als z. B. JSON.
  • Nachteil: durch Einrückungen anfällig für Fehler; Parsing und Standardisierung weniger streng.

Wikitext

Wikitext ist eine vereinfachte Auszeichnungssprache, die entwickelt wurde, um Texte direkt im Browser zu bearbeiten und zu formatieren, ohne HTML oder CSS kennen zu müssen.

Vorteile

  • Einfach zu erlernen und zu lesen
  • Speziell für kollaboratives Schreiben entwickelt
  • Versionskontrolle integriert

Nachteile

  • Uneinheitliche Syntax zwischen Wiki-Systemen
  • Eingeschränkte Wiederverwendbarkeit außerhalb von Wikis
  • Verwirrende Mischsyntax (z.B. eingebettetes HTML)

CSV Comma separated Value

  • Einfaches tabellarisches Textformat, sehr verbreitet für Export/Import von Tabellen / Spreadsheet-Daten.
  • Vorteil: extrem einfach, fast überall unterstützt.
  • Nachteil: kaum Struktur (nur Zeilen & Spalten), keine eingebetteten Datenstrukturen

XML eXtentible Markup Language

  • Älteres Format, textbasiert, sowohl für Dokumente als auch Daten­austausch.
  • Vorteil: sehr mächtig, unterstützt komplexe Strukturen, Schema etc.
  • Nachteil: im Vergleich unübersichtlicher, viele Codezeilen, wird in vielen modernen Anwendungen seltener primär gewählt.

JSON

  • textbasiert, mehrfach standardisiert (ISO/IEC 21778:2017) und weit verbreitet.
  • Ideal für Daten­austausch zwischen Systemen, Web­schnittstellen & APIs.
  • Vorteil: klare Struktur mit Objekten (Key/Value) und Arrays, gut lesbar für Menschen und Maschinen.
  • Nachteil: keine Kommentare, weniger freundlich für komplexe Konfigurations­dateien.

versus

maschinenlesbar, aber nicht menschenlesbar.

Binärdatei

oder