# JSON-Leitfaden: Dokumente und Daten in JSON umwandeln und zurück

> Dieser Leitfaden erklärt, wie die JSON-Werkzeuge Dateien lesen und schreiben, das Dokumentformat von PDF und Word in JSON und welches Werkzeug wofür passt.

- Seite: https://acepdfmd.com/de/guides/json-guide/
- Aktualisiert: 2026-09-21
- Läuft auf: https://acepdfmd.com (Hochgeladene Dateien werden innerhalb von 60 Minuten gelöscht. Keine Anmeldung für gelegentliche Nutzung.)
- Auch in 29 Sprachen: https://acepdfmd.com/<lang>/guides/json-guide/

## Warum JSON

JSON ist das Datenformat, das Programme, Webdienste und KI-Modelle am leichtesten lesen: Objekte mit benannten Feldern, Listen, Zahlen, Text, true, false und null, nichts weiter. Dokumente und Tabellenkalkulationen werden nicht so gespeichert. Die Werkzeuge dieser Familie überbrücken die Lücke in beide Richtungen: Sie wandeln PDFs, Word-Dateien, Tabellenkalkulationen, CSV, YAML und XML in JSON um, und sie wandeln JSON zurück in Dateien, die Menschen lesen, etwa PDF, Word, Excel, CSV und HTML.

Jedes Werkzeug läuft auf unseren Servern über eine sichere Verbindung und löscht die hochgeladene Datei innerhalb von 60 Minuten. Texteingaben können direkt eingefügt werden, statt hochgeladen zu werden.

## Welches Werkzeug für welche Aufgabe

| Sie haben | Sie möchten | Verwenden Sie |
|---|---|---|
| Ein PDF | Text, Tabellen und Metadaten als Daten | [PDF in JSON](https://acepdfmd.com/de/tool/pdf-to-json/) |
| Ein Word-Dokument | Überschriften, Absätze, Listen und Tabellen als Daten | [Word in JSON](https://acepdfmd.com/de/tool/word-to-json/) |
| Eine Excel-Arbeitsmappe | Datensätze, Zeilen oder Spalten | [Excel in JSON](https://acepdfmd.com/de/tool/excel-to-json/) |
| Eine CSV- oder TSV-Datei | Ein JSON-Array mit typisierten Werten | [CSV in JSON](https://acepdfmd.com/de/tool/csv-to-json/) |
| Eine YAML-Datei | Dieselben Daten als JSON | [YAML in JSON](https://acepdfmd.com/de/tool/yaml-to-json/) |
| Eine XML-Datei | Objekte, Attribute und Arrays | [XML in JSON](https://acepdfmd.com/de/tool/xml-to-json/) |
| JSON | Ein PDF zum Lesen oder Drucken | [JSON in PDF](https://acepdfmd.com/de/tool/json-to-pdf/) |
| JSON | Eine Excel-Arbeitsmappe | [JSON in Excel](https://acepdfmd.com/de/tool/json-to-excel/) |
| JSON | Eine CSV-Datei | [JSON in CSV](https://acepdfmd.com/de/tool/json-to-csv/) |
| JSON | Ein bearbeitbares Word-Dokument | [JSON in Word](https://acepdfmd.com/de/tool/json-to-word/) |
| JSON | Eine Webseite | [JSON in HTML](https://acepdfmd.com/de/tool/json-to-html/) |
| JSON | YAML für eine Konfigurationsdatei | [JSON in YAML](https://acepdfmd.com/de/tool/json-to-yaml/) |
| JSON | XML für ein anderes System | [JSON in XML](https://acepdfmd.com/de/tool/json-to-xml/) |
| JSON, das unsauber oder ungültig ist | Sauberes, gültiges JSON | [JSON-Formatierer](https://acepdfmd.com/de/tool/json-formatter/) |
| Zwei JSON-Dateien | Eine Liste der Unterschiede | [JSON vergleichen](https://acepdfmd.com/de/tool/json-compare/) |

Markdown hat sein eigenes Paar: [Markdown zu JSON](https://acepdfmd.com/de/tool/markdown-to-json/) exportiert einen Dokumentbaum, und [JSON zu Markdown](https://acepdfmd.com/de/tool/json-to-markdown/) wandelt JSON in eine Markdown-Gliederung oder -Tabelle um.

## Das Dokumentformat

PDF in JSON und Word in JSON schreiben dieselbe Form, sodass ein einziger Code beide verarbeitet. Die oberste Ebene enthält immer diese Felder:

```json
{
  "format": "acepdfmd-document",
  "version": 1,
  "source": {"type": "pdf", "filename": "report.pdf", "title": "Q3 Report", "pages": 12},
  "pages": [{"number": 1, "width": 612, "height": 792, "words": 380, "text": "..."}],
  "blocks": [
    {"type": "heading", "level": 1, "text": "Q3 Report"},
    {"type": "paragraph", "text": "Revenue grew..."},
    {"type": "list", "ordered": false, "items": [{"level": 0, "text": "Europe"}]},
    {"type": "table", "header": ["Region", "Q3"], "rows": [["Europe", 1200.5]]}
  ],
  "tables": [{"index": 1, "page": 3, "rows": [["Region", "Q3"], ["Europe", 1200.5]]}],
  "form_fields": [{"name": "email", "type": "text", "value": "a@b.com"}],
  "extraction": {"engine": "pdf_to_markdown/layout", "mode": "structure", "ocr": false, "warnings": []}
}
```

Die Felder bedeuten Folgendes:

- source: was die Datei war, mit den Metadaten, die sie enthielt (Titel, Autor, Betreff, Schlüsselwörter, Erstellungs- und Änderungsdatum, Seitenzahl). Word-Dateien fügen die Wort-, Tabellen- und Bildanzahl hinzu.
- pages: ein Eintrag pro PDF-Seite mit ihrer Größe in Punkten, ihrer Drehung, einer Wortanzahl und ihrem Text. Word-Dateien haben keine Seiten, da Word Seiten nur beim Drucken anlegt.
- blocks: das Dokument in Lesereihenfolge. Typen sind heading (mit Ebene 1 bis 6), paragraph (mit einem optionalen Formatvorlagennamen aus Word), list (geordnet oder nicht, Elemente mit einer Verschachtelungsebene), table (Kopfzeile plus typisierte Zeilen), code, blockquote, rule und image.
- tables: für PDFs jede erkannte Tabelle mit der Seite, auf der sie gefunden wurde, und, bei einer fortlaufenden Tabelle, der Seite, auf der sie endet. Zellen, die wie Zahlen aussehen, sind Zahlen.
- form_fields: nur vorhanden, wenn das PDF ein Formular enthält. Jedes Feld hat seinen Namen, Typ (text, choice, button oder signature) und aktuellen Wert.
- extraction: welcher Konverter lief, welcher Modus gewählt wurde, ob OCR nötig war, und etwaige Warnungen, etwa eine Tabelle, die nicht erkannt werden konnte.

Version 1 dieses Formats gewinnt nur Felder hinzu; bestehende Felder behalten ihre Namen und Bedeutung.

## Tabellarische Daten und Verschachtelung

CSV und Excel sind flach, JSON ist es nicht. Wenn JSON zu CSV oder Excel wird, werden verschachtelte Objekte zu Spaltennamen mit Punktnotation und Arrays zu durchnummerierten Spalten abgeflacht, sodass ein Bestellungsdatensatz mit einem customer-Objekt und einem items-Array zu Spalten wie customer.name, items[0].sku und items[1].sku wird. Wenn CSV oder Excel zurück zu JSON wird, werden auf diese Weise geschriebene Kopfzeilen zu verschachtelten Objekten und Arrays zusammengesetzt. Eine Kopfzeile mit einem gewöhnlichen Punkt, etwa eine Versionsnummer oder eine Abkürzung, wird unverändert gelassen.

Werte werden beim Einlesen typisiert: Zahlen werden zu Zahlen, true und false werden zu Booleans, eine leere Zelle wird zu null, und alles andere bleibt eine Zeichenkette. Datumswerte aus Excel werden als ISO-8601-Zeichenketten geschrieben, da JSON keinen Datentyp für Datumsangaben besitzt. Stellen Sie die Werttypen auf Text um, wenn Kennungen mit führenden Nullen exakt wie geschrieben erhalten bleiben müssen.

## Validierung und Reparatur

Jedes JSON-Werkzeug validiert seine Eingabe auf dieselbe Weise. Eine ungültige Datei wird abgelehnt, mit Zeile und Spalte des ersten Fehlers und einem kurzen Ausschnitt dieser Zeile. Der [JSON-Formatierer](https://acepdfmd.com/de/tool/json-formatter/) kann außerdem die Fehler reparieren, die am häufigsten eingefügt werden: Kommentare, überflüssige Kommas, einfache Anführungszeichen, unquotierte Schlüssel, großgeschriebenes True, False und None, NaN und Infinity, und Codeblöcke um den Text. Wenn eine Reparatur angewendet wurde, zeigt das Ergebnis dies an, damit sich das Verhalten nicht unbemerkt ändert.

## Datenschutz

Hochgeladene Dateien und eingefügter Text werden auf unseren Servern verarbeitet und innerhalb von 60 Minuten gelöscht; Einzelheiten finden Sie im [Datenschutz-Leitfaden](https://acepdfmd.com/de/guides/privacy-guide/). Nichts wird über diese Zeit hinaus gespeichert, und nichts wird für einen anderen Zweck verwendet.

## In dieser Anleitung erwähnte Werkzeuge

- [PDF in JSON](https://acepdfmd.com/de/tool/pdf-to-json/): Extrahiert Text, Überschriften, Listen, Tabellen, Formularfelder und Metadaten eines PDFs als strukturiertes JSON.
- [Word in JSON](https://acepdfmd.com/de/tool/word-to-json/): Wandelt ein Word-Dokument in JSON um: Überschriften, Absätze, Listen und Tabellen in Lesereihenfolge.
- [Excel in JSON](https://acepdfmd.com/de/tool/excel-to-json/): Wandelt Excel-Arbeitsblätter in JSON-Datensätze, -Zeilen oder -Spalten mit echten Zahlen und Datumswerten um.
- [CSV in JSON](https://acepdfmd.com/de/tool/csv-to-json/): Wandelt CSV oder TSV in ein JSON-Array von Objekten um, mit typisierten Zahlen und verschachtelten Schlüsseln.
- [YAML in JSON](https://acepdfmd.com/de/tool/yaml-to-json/): Wandelt YAML in sauberes JSON um, einschließlich Dateien mit mehreren Dokumenten.
- [XML in JSON](https://acepdfmd.com/de/tool/xml-to-json/): Wandelt XML in JSON um, mit Attributen, wiederholten Elementen als Arrays und typisierten Werten.
- [JSON in PDF](https://acepdfmd.com/de/tool/json-to-pdf/): Wandelt JSON in ein lesbares PDF um: Datensätze werden zu Tabellen, verschachtelte Daten zu einer Gliederung.
- [JSON in Excel](https://acepdfmd.com/de/tool/json-to-excel/): Wandelt JSON in eine Excel-Arbeitsmappe um, ein Blatt pro Datensatzliste, verschachtelte Schlüssel als Spalten.
- [JSON in CSV](https://acepdfmd.com/de/tool/json-to-csv/): Flacht JSON-Datensätze zu einer CSV-Datei ab, die sich in jeder Tabellenkalkulation öffnen lässt.
- [JSON in Word](https://acepdfmd.com/de/tool/json-to-word/): Wandelt JSON in ein bearbeitbares Word-Dokument mit Überschriften, Listen und Tabellen um.
- [JSON in HTML](https://acepdfmd.com/de/tool/json-to-html/): Rendert JSON als eigenständige HTML-Seite mit Tabellen und einer druckbaren Gliederung.
- [JSON in YAML](https://acepdfmd.com/de/tool/json-to-yaml/): Wandelt JSON in lesbares YAML um, mit Schlüsseln in ihrer ursprünglichen Reihenfolge.
- [JSON in XML](https://acepdfmd.com/de/tool/json-to-xml/): Wandelt JSON in wohlgeformtes, eingerücktes XML mit einem von Ihnen gewählten Wurzelelement um.
- [JSON-Formatierer](https://acepdfmd.com/de/tool/json-formatter/): Validiert, formatiert, minimiert, sortiert oder repariert JSON, mit der genauen Zeile und Spalte jedes Fehlers.
- [JSON vergleichen](https://acepdfmd.com/de/tool/json-compare/): Vergleicht zwei JSON-Dateien strukturell und listet jeden hinzugefügten, entfernten und geänderten Wert nach Pfad auf.
- [Markdown zu JSON](https://acepdfmd.com/de/tool/markdown-to-json/): Die Dokumentstruktur als JSON-Syntaxbaum (pandoc-AST) exportieren.
- [JSON zu Markdown](https://acepdfmd.com/de/tool/json-to-markdown/): JSON-Daten oder einen pandoc-AST in lesbares Markdown mit Tabellen umwandeln.

## Weitere Anleitungen

- [Markdown-Spickzettel: Syntaxreferenz mit Beispielen](https://acepdfmd.com/de/guides/markdown-cheat-sheet/)
- [PDF-Seitengrößen und Abmessungen: A4, Letter, Legal und mehr](https://acepdfmd.com/de/guides/pdf-page-sizes/)
- [PDF-Kompression erklärt: warum manche Dateien kaum kleiner werden](https://acepdfmd.com/de/guides/pdf-compression-guide/)
- [PDF zu Markdown: Wie es funktioniert und wie man es für KI einsetzt](https://acepdfmd.com/de/guides/pdf-to-markdown-guide/)
- [OCR für PDFs und Bilder: So erhältst du genauen Text](https://acepdfmd.com/de/guides/ocr-guide/)
- [Ist es sicher, ein PDF online hochzuladen? Ein Datenschutz-Leitfaden](https://acepdfmd.com/de/guides/privacy-guide/)
- [iWork-Dateien (Pages, Numbers, Keynote) ohne Mac öffnen und umwandeln](https://acepdfmd.com/de/guides/iwork-guide/)