JSON und CSV in Markdown-Tabellen umwandeln

JSON oder CSV als Markdown-Tabelle nutzen

Mit diesem Werkzeug wandeln Sie Text im Format JSON oder CSV in eine Markdown-Tabelle um. Das eignet sich, wenn Daten bereits als strukturierter Text vorliegen und Sie daraus eine Tabelle für eine Markdown-Datei oder einen anderen Markdown-fähigen Arbeitsbereich benötigen. Bei erfolgreicher Verarbeitung entsteht formatierter Markdown-Tabellentext. Für JSON und CSV gelten dabei unterschiedliche Regeln für die Kopfzeile und die Datenzeilen.

Daten einfügen und Tabelle erzeugen

1. Bereiten Sie Ihre Daten als Text vor. Wählen Sie für strukturierte Datensätze entweder json oder csv als Eingabeformat. Eine leere Dateneingabe führt nicht zu einer Tabelle.

2. Fügen Sie den JSON- oder CSV-Text in das Datenfeld ein. Bei JSON muss der Inhalt gültig sein und eine passende Zeilenstruktur liefern. Ein nicht leeres JSON-Objekt wird als eine Tabellenzeile behandelt. Bei CSV werden Zeilen an Zeilenumbrüchen und Felder an Kommas getrennt; Leerraum am Anfang und Ende jedes Feldes wird entfernt.

3. Legen Sie bei Bedarf eigene Spaltenüberschriften fest. Geben Sie sie als durch Kommas getrennten Text ein. Leerraum um die einzelnen Überschriften wird entfernt. Ohne eigene Überschriften nimmt das Werkzeug bei geeignetem JSON die Schlüssel der ersten Zeile. Bei CSV liefert die erste Zeile die Überschriften, die folgenden Zeilen bilden die Daten.

4. Wählen Sie die Ausrichtung für die Tabelle: left, center oder right. Wenn Sie keine Auswahl treffen, wird links ausgerichtet. Ein anderer Wert fällt ebenfalls auf links ausgerichtete Tabellenmarkierungen zurück.

5. Starten Sie die Verarbeitung und prüfen Sie den ausgegebenen Markdown-Text. Übernehmen Sie ihn erst dann in Ihr Dokument, wenn Spalten, Zeilen und Überschriften zu Ihrer Eingabe passen.

Ausgabe und Grenzen richtig einordnen

Eine erfolgreiche Verarbeitung liefert eine formatierte Markdown-Tabelle als Text. Bei JSON ohne eigene Überschriften entsprechen die Spaltennamen den Schlüsseln der ersten geeigneten Zeile. Bei CSV steht die erste Eingabezeile für die Überschriften. Die Ausrichtung erkennen Sie an den Markdown-Tabellenmarkierungen: Die gewählte Option steuert, ob Werte links, mittig oder rechts ausgerichtet werden.

Ein leeres JSON-Ergebnis ist nicht dasselbe wie eine Tabelle mit einer leeren Zeile. Ein leerer Wert, eine leere Liste, ein leeres Objekt, null, false, 0 oder eine leere Zeichenfolge wird als leere Tabelle behandelt. Auch gültiges JSON kann scheitern, wenn seine Struktur nicht die erwartete Zeilenform liefert. Fehlerhaftes JSON führt ebenfalls zu einem nicht erfolgreichen Ergebnis.

Bei CSV sollten Sie die einfache Trennung an Kommas und Zeilenumbrüchen berücksichtigen. Die Verarbeitung ist deshalb nicht als vollständiger CSV-Parser für komplexe CSV-Konventionen zu verstehen. Felder nach der Zahl der vorhandenen Überschriften werden verworfen; fehlende Felder bleiben in der betreffenden Zeile leer.

Praktisches Beispiel

Sie möchten eine kurze Statusliste aus JSON in eine Markdown-Dokumentation übernehmen.

Fügen Sie [{"Name":"Mina","Status":"aktiv"}] als JSON ein, wählen Sie json und verzichten Sie auf eigene Überschriften. Prüfen Sie danach, ob die Ausgabe eine Markdown-Tabelle mit den beiden JSON-Schlüsseln als Spalten enthält.

Eine Markdown-Tabelle mit den Spalten Name und Status sowie einer Datenzeile für Mina und aktiv; die genaue Ausgabe hängt von der Verarbeitung ab.

Einschränkungen

• Für diese Anleitung ist kein Netzwerkzugriff angegeben. Daraus lassen sich jedoch keine Aussagen über Speicherung, Aufbewahrung oder Datenschutz ableiten.
• CSV wird durch die direkte Trennung an Zeilenumbrüchen und Kommas verarbeitet. Komplexe CSV-Konventionen wie geschützte Kommas sind daher nicht zugesichert; überzählige Felder werden verworfen und fehlende Felder bleiben leer.

Häufige Fehler

• Wenn keine Tabelle entsteht, prüfen Sie zuerst das gewählte Format und die JSON-Syntax. Unterstützt werden nur json und csv; ungültiges JSON oder eine ungeeignete gültige JSON-Struktur kann die Verarbeitung ebenfalls scheitern lassen.

Häufige Fragen

Welche Eingabeformate werden unterstützt?

Wählen Sie json oder csv. Andere Formatwerte führen zu einem nicht erfolgreichen Ergebnis.

Wie entstehen die Spaltenüberschriften bei JSON?

Bei geeignetem, nicht leerem JSON werden ohne eigene Überschriften die Schlüssel der ersten Zeile verwendet. Ein nicht leeres JSON-Objekt zählt als eine Zeile.

Welche Ausrichtungen kann die Markdown-Tabelle haben?

Sie können left, center oder right auswählen. Ohne Auswahl und bei einem nicht unterstützten Wert wird links ausgerichtet.