---
title: "JSON, YAML und Markdown erklärt"
description: "JSON, YAML und Markdown sind drei Klartext-Formate, denen du ständig begegnest. Lerne, wofür jedes da ist und wie du sie auf einen Blick liest."
type: "fundamental"
locale: "de-CH"
category: "concepts"
canonical: "https://agenticschool.dev/de/grundlagen/json-yaml-markdown"
dateModified: "2026-06-12"
---

# JSON, YAML und Markdown erklärt

- Kategorie: concepts
- Aktualisiert: 2026-06-12
- Keywords: JSON, YAML, Markdown, config files, data formats
- Kanonische URL: https://agenticschool.dev/de/grundlagen/json-yaml-markdown
- Sprache: de-CH

> JSON, YAML und Markdown sind drei Klartext-Formate, denen du ständig begegnest. Lerne, wofür jedes da ist und wie du sie auf einen Blick liest.

JSON, YAML und Markdown sind drei Klartext-Formate, denen du beim Bauen ständig begegnest. JSON und YAML speichern beide strukturierte Daten wie Einstellungen und Listen, während Markdown für formatierten Text wie Dokumentation und Notizen da ist. Keines davon ist eine Programmiersprache; es sind nur vereinbarte Arten, Informationen so zu schreiben, dass sowohl Menschen als auch Programme sie lesen können. Sobald du die drei erkennst, hören die meisten Config-Dateien auf, beängstigend auszusehen.

## JSON: Daten für Maschinen

JSON (JavaScript Object Notation) speichert Daten als Schlüssel-Wert-Paare, mit geschweiften Klammern und Anführungszeichen. Es ist überall: API-Antworten, Paket-Dateien, App-Einstellungen. Es ist streng, also bricht ein einziges fehlendes Komma oder Anführungszeichen es.

```json
{
  "name": "my-app",
  "version": "1.0.0",
  "private": true
}
```
Schlüssel und String-Werte stehen immer in doppelten Anführungszeichen.

## YAML: Daten für Menschen

YAML speichert dieselbe Art Daten wie JSON, nutzt aber Einrückung statt Klammern, was es leichter von Hand lesbar und schreibbar macht. Es ist üblich in Workflow- und Deploy-Config. Der Haken: Abstände zählen. YAML nutzt Leerzeichen zur Einrückung, niemals Tabs.

```yaml
name: my-app
version: 1.0.0
private: true
```
Dieselben Daten wie das JSON oben, Einrückung statt Klammern.

## Markdown: formatiertes Schreiben

Markdown ist für Text, nicht für Daten. Du fügst einfache Symbole zu Klartext hinzu, um Überschriften, Fettdruck, Listen und Links zu markieren, und es wird als schön formatierter Inhalt dargestellt. Diese Seite, die meisten READMEs und KI-Anweisungsdateien wie CLAUDE.md sind alle Markdown.

```markdown
# Eine Überschrift

Etwas **fetter** Text und eine Liste:

- erster Eintrag
- zweiter Eintrag
```
Ein "#" macht eine Überschrift; "**text**" macht ihn fett; "-" macht eine Liste.

## Wie du sie auseinanderhältst

Eine schnelle Faustregel klärt die meiste Verwirrung. Wenn du geschweifte Klammern und viele Anführungszeichen siehst, ist es JSON. Wenn du saubere Einrückung mit Doppelpunkten und ohne Klammern siehst, ist es YAML. Wenn du "#"-Überschriften und "-"-Bullets siehst, die für einen Menschen gedacht sind, ist es Markdown. Du musst keines davon perfekt von Hand schreiben, weil dein KI Agent diese Dateien für dich erzeugt und bearbeitet. Es hilft, zu erkennen, was was ist, damit du, wenn ein Tool nach "einer YAML-Config" oder "einer JSON-Datei" fragt, weisst, was es erwartet, und einen offensichtlichen Fehler auf einen Blick siehst.

## Häufige Fragen

### Wann nutze ich JSON vs YAML?

Sie speichern dieselbe Art Daten. JSON ist strenger und üblich in Code und APIs; YAML ist freundlicher zum Lesen und Schreiben von Hand und üblich in Config. Oft entscheidet das Tool, welches du brauchst.

### Ist Markdown eine Programmiersprache?

Nein. Markdown ist eine einfache Art, Text mit Klartext-Symbolen zu formatieren. Es wird für Dokumentation, Notizen und KI-Anweisungsdateien genutzt, nicht für Logik oder Daten.

### Warum bricht mein YAML ständig?

Fast immer die Einrückung. YAML nutzt Leerzeichen, nie Tabs, und die Anzahl der Leerzeichen zählt. Richte alles konsistent aus, und die meisten YAML-Fehler verschwinden.