Startseite › Entwickler-Tools › JSON in Markdown-Tabelle

JSON in Markdown-Tabelle

Füge ein JSON-Array von Objekten ein und erhalte eine saubere Tabelle in GitHub Flavored Markdown für READMEs, Dokus, Issues und Wikis. Wähle und sortiere Spalten, flache verschachtelte Objekte ab, lege die Ausrichtung fest und prüfe die gerenderte Vorschau.

Zuletzt aktualisiert:

Lokal in deinem Browser umgewandelt; dein JSON wird nie hochgeladen. Die Ausgabe folgt der Tabellensyntax von GitHub Flavored Markdown.

Anzeige
Anzeige

Anleitung: JSON in Markdown-Tabelle

  1. Füge dein JSON ein, meist ein Array von Objekten wie eine API-Antwort, oder öffne eine .json-Datei. Zum Start ist ein Beispiel geladen.
  2. Wähle die Spalten: Entferne die Haken bei denen, die du nicht brauchst, und ändere die Reihenfolge mit den Pfeilen.
  3. Lege fest, wie verschachtelte Daten erscheinen: als abgeflachte Punkt-Spalten, kompaktes JSON oder JSON als Code.
  4. Stelle Ausrichtung und Stil ein: Spaltenausrichtung, Ausrichtung von Zahlen, Text für null, Kopfzeilen in Title Case, Zeilennummern und Auffüllen.
  5. Prüfe den Tab Vorschau, kopiere dann das Markdown oder lade es als .md-Datei herunter und füge es in deine README oder dein Issue ein.

Beispiel: JSON-Array in Markdown-Tabelle

[
  {"name": "Ada", "role": "Engineer", "salary": 120000, "address": {"city": "London"}},
  {"name": "Alan", "role": "Researcher", "salary": 98500.5, "address": {"city": "Manchester"}}
]

wird zu dieser Tabelle, wobei das verschachtelte address in eine eigene Spalte abgeflacht und die Zahlenspalte rechtsbündig ist:

| name | role       |  salary | address.city |
| ---- | ---------- | ------: | ------------ |
| Ada  | Engineer   |  120000 | London       |
| Alan | Researcher | 98500.5 | Manchester   |

Spickzettel zur Markdown-Tabellensyntax

TeilSyntaxHinweise
Kopfzeile| Name | Alter |Pflicht. Jede Tabelle braucht genau eine Kopfzeile.
Trennzeile| --- | --- |In vielen Renderern mindestens drei Bindestriche pro Spalte; Doppelpunkte legen die Ausrichtung fest.
Linksbündig:---Entspricht auf den meisten Seiten dem Standard.
Zentriert:---:Gut für kurze Statuswerte wie ✓ oder Ja/Nein.
Rechtsbündig---:Ideal für Zahlen, damit die Ziffern untereinander stehen.
Pipe in einer Zelle\|Ein nicht maskiertes | beginnt eine neue Zelle.
Zeilenumbruch in einer Zelle<br>Zellen können sich nicht über mehrere Quellzeilen erstrecken.
Leere Zelle| |Lass den Raum zwischen den Pipes leer.

Tipps für gut lesbare Tabellen

  • Blende aus, was Leser nicht brauchen. API-Antworten enthalten oft IDs, Zeitstempel und URLs; entferne die Haken bei diesen Spalten, damit die Tabelle schmal genug für eine README bleibt.
  • Auffüllen ist optional. Renderer ignorieren die zusätzlichen Leerzeichen, aber aufgefüllter Quelltext ist in einem Pull-Request-Diff viel leichter zu lesen und zu prüfen. Schalte das Auffüllen für die kleinste Ausgabe aus.
  • Sehr lange Werte lassen Tabellen auf GitHub seitlich scrollen. Flache am besten nur die benötigten Felder ab oder kürze Texte vor dem Umwandeln.
  • Andersherum? Für eine Tabelle, die du von Hand eingibst, nutze den Markdown-Tabellengenerator; für HTML-Ausgabe nutze JSON in HTML-Tabelle.

Häufige Fragen

Welche JSON-Strukturen lassen sich umwandeln?

Am besten funktioniert ein Array von Objekten: Jedes Objekt wird zu einer Zeile und jeder Schlüssel zu einer Spalte. Das Tool akzeptiert auch ein Objekt, dessen Werte Objekte sind (jedes wird zu einer Zeile mit einer Schlüsselspalte), ein Array aus Arrays (die erste Zeile wird zur Kopfzeile, wenn sie nur Strings enthält), ein Array einfacher Werte (eine Wertespalte) und ein einzelnes Objekt (eine Zeile).

Was passiert, wenn Objekte unterschiedliche Schlüssel haben?

Die Spalten sind die Vereinigung aller Schlüssel in der Reihenfolge ihres ersten Auftretens. Eine Zeile ohne einen Schlüssel erhält eine leere Zelle oder den Text, den du für null und fehlende Werte wählst, etwa null, einen Gedankenstrich oder N/A.

Wie werden verschachtelte Objekte und Arrays angezeigt?

Standardmäßig werden verschachtelte Objekte in Spalten mit Punktnotation abgeflacht, sodass address.city eine eigene Spalte wird, und Arrays einfacher Werte werden mit Kommas verbunden. Alternativ kannst du verschachtelte Werte als kompaktes JSON behalten, optional in Backticks, damit Markdown sie als Code anzeigt.

Wie richte ich Spalten in einer Markdown-Tabelle aus?

Die Ausrichtung wird in der Trennzeile unter der Kopfzeile festgelegt: :--- richtet links aus, :---: zentriert und ---: richtet rechts aus. Einfaches --- verwendet den Standard des Renderers, auf GitHub linksbündig. Mit „Zahlenspalten rechtsbündig“ werden Spalten, die nur Zahlen enthalten, automatisch rechtsbündig ausgerichtet, damit die Ziffern untereinander stehen.

Was, wenn ein Wert ein Pipe-Zeichen oder einen Zeilenumbruch enthält?

Ein rohes | würde die Zelle vorzeitig beenden, daher maskiert das Tool es als \|. Zellen in Markdown-Tabellen müssen in einer Zeile bleiben, daher werden Zeilenumbrüche in Werten durch <br> ersetzt, das GitHub, GitLab und die meisten Renderer als Zeilenumbruch anzeigen.

Wo kann ich die erzeugte Tabelle verwenden?

Die Ausgabe folgt der Tabellensyntax von GitHub Flavored Markdown, die von READMEs, Issues und Wikis auf GitHub und GitLab, Bitbucket, Obsidian, Docusaurus, MkDocs und den meisten Static-Site-Generatoren unterstützt wird.

Wird mein JSON hochgeladen?

Nein. Die Umwandlung läuft komplett in JavaScript auf dieser Seite, sodass deine Daten nie dein Gerät verlassen.

Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

Ähnliche Tools

Alle Daten- & Dateiformat-Konverter ansehen →