JSON-Ausgabe
Die Beispiel-Markdown-Tabelle erzeugt dieses JSON:
[
{ "Name": "Alice", "Age": "30", "City": "Istanbul" },
{ "Name": "Bob", "Age": "25", "City": "Ankara" }
]
Die Kopfzeile definiert die Schlüssel. Jede Datenzeile wird zu einem Objekt. Alle Werte sind Strings, da Markdown keine Typinformation hat.
Wie Markdown-Tabellen auf JSON abgebildet werden
Markdown-Tabellen haben eine einfache, vorhersagbare Struktur, die direkt auf JSON abgebildet wird.
| Markdown-Syntax | JSON-Entsprechung |
|---|---|
Kopfzeile | Name | Age | | Objektschlüssel |
Trennzeile | --- | --- | | Wird ignoriert |
| Datenzeilen | Array-Elemente |
| Zellenwert | Eigenschaftswert (String) |
| Leere Zelle | Leerer String |
Das Pipe-Zeichen wirkt als Spaltentrennzeichen. Die Trennlinie (die Bindestriche und optional Doppelpunkte für Ausrichtung enthält) ist reine Syntax und erzeugt keine Daten in der Ausgabe.
Wann Markdown zu JSON konvertieren
README-Verarbeitung
README-Dateien enthalten häufig Tabellen, die Funktionen, Abhängigkeiten oder Konfigurationsoptionen auflisten. Das Konvertieren dieser Tabellen zu JSON ermöglicht das programmatische Validieren oder Vergleichen von Dokumentation über Versionen hinweg.
Dokumentationspipelines
Wenn du Dokumentation in Markdown pflegst und strukturierte Daten in ein Build-System einspeisen musst, gibt dir das Konvertieren von Tabellen zu JSON ein sauberes Eingabeformat für Templates, SuchoIndexe oder statische Site-Generatoren.
Datextraktion aus Dokumenten
Technische Dokumentation enthält häufig Datentabellen: API-Parameter, Statuscodes, Versionsvergleiche. Das Konvertieren dieser Markdown-Tabellen zu JSON ermöglicht das Extrahieren dieser Daten in Test-Fixtures, Validierungsschemas oder Referenzdaten.
Notizen und Wissensbasen
Markdown ist das Standardformat für Notiz-Tools. Wenn du strukturierte Daten in Markdown-Tabellen verfolgst (Aufgabenlisten, Inventare, Zeitpläne), ermöglicht dir die Konvertierung zu JSON, Abfragen und Ansichten über diese Daten zu erstellen.
Umgang mit Grenzfällen
Ausrichtungs-Doppelpunkte
Markdown-Tabellenzellen können Ausrichtungsmarker in der Trennlinie haben: :--- für links, ---: für rechts, :---: für zentriert. Der Konverter ignoriert diese, da Ausrichtung eine Darstellungs- und keine Datenfrage ist.
Pipe-Zeichen in Werten
Wenn ein Zellenwert ein Pipe-Zeichen enthält, muss die Markdown-Quelle es mit einem umgekehrten Schrägstrich escapen (\|). Der Konverter behandelt escaped Pipes korrekt und behandelt das wörtliche Pipe als Inhalt statt als Trennzeichen.
Inkonsistente Spaltenzahlen
Markdown erfordert, dass jede Zeile die gleiche Anzahl von Spalten hat. Wenn eine Zeile weniger Zellen hat, füllt der Konverter fehlende Werte mit leeren Strings. Wenn eine Zeile zusätzliche Zellen hat, ignoriert der Konverter diese typischerweise.
Markdown-Listen-Konvertierung
Über Tabellen hinaus werden Markdown-Listen zu JSON-Arrays konvertiert. Verschachtelte Listen erzeugen verschachtelte Arrays. Eine Aufgabenliste mit Kontrollkästchen erzeugt Objekte mit Verifizierungsstatus:
- [x] Design abschließen
- [ ] Tests schreiben
- [ ] Bereitstellen
Wird zu:
[
{ "text": "Design abschließen", "checked": true },
{ "text": "Tests schreiben", "checked": false },
{ "text": "Bereitstellen", "checked": false }
]
Diese Konvertierung ist nützlich zum Extrahieren von Aufgabendaten aus Markdown-Dateien in Projektmanagement-Tools oder CI/CD-Pipelines.