Markdown-Tabelle in HTML und JSON umwandeln: Regeln & Stolpersteine

Inhalt
Eine Markdown-Tabelle (Pipe-Syntax), ein HTML-<table>-Tag und ein JSON-Array aus Objekten unterscheiden sich nur in der Darstellung. Die enthaltenen Daten, also Kopfzeile und Wertzeilen, sind identisch. Dieser Artikel erklärt, nach welchen Regeln sich die drei Formate einander zuordnen lassen und wie in der Praxis damit umgegangen wird, wenn die Spaltenanzahl nicht übereinstimmt oder die Trennzeile unter der Kopfzeile fehlt.
Kurzfassung ① Die erste Zeile einer Markdown-Tabelle ist die Kopfzeile. Ob die zweite Zeile eine Trennzeile ist, wird daran erkannt, ob sie das Zeichen
-enthält. ② Bei HTML dienen<th>/<td>innerhalb von<tr>als Kopfzeile, bei JSON die Schlüssel (Keys) des ersten Objekts. ③ Hat eine Zeile mehr oder weniger Zellen als die Kopfzeile, werden fehlende Zellen automatisch mit leeren Werten aufgefüllt und überzählige verworfen. Sie müssen die Anzahl also nicht selbst angleichen.
Wo es hakt, wenn Sie Markdown-Tabellen in HTML oder JSON umwandeln
Häufig steht man vor folgendem Problem: Im Blogbeitrag wurde eine Markdown-Tabelle verwendet, auf der Website muss aber HTML eingefügt werden. Oder umgekehrt: Ein von einer API gelieferter JSON-Array soll als Markdown-Tabelle in die Dokumentation. Bei ein oder zwei Tabellen geht das noch von Hand. Sobald es aber mehrere Dutzend Zeilen werden, schleichen sich beim Abzählen der Pipe-Zeichen (|) oder beim Öffnen der <td>-Tags einzeln leicht Tippfehler ein.
Die drei Formate von Hand umwandeln: es gilt nur eine Regel
Alle drei Formate stellen Daten als eine „Kopfzeile“ und mehrere „Wertzeilen“ dar. Der Unterschied zwischen den Formaten liegt allein in der Syntax, die diese beiden Teile umschließt.
- Markdown → HTML: Jede Zelle der ersten Zeile wird zu einem
<th>, jede Zelle der folgenden Zeilen (ohne die Trennzeile) zu einem<td>. Jede Zeile wird in ein<tr>eingefasst. - HTML → Markdown: Jedes
<tr>wird zu einer Zeile. Die<td>-/<th>-Werte darin werden durch|getrennt aufgelistet, und unter der Kopfzeile folgt eine Trennzeile in der Form|---|---|. - JSON → Markdown/HTML: Die Schlüsselnamen des ersten Objekts im Array bilden die Kopfzeile. Die Werte jedes Objekts ergeben, in der Reihenfolge dieser Schlüssel, jeweils eine Zeile.
Mit diesen drei Regeln lassen sich beliebig viele Tabellen auch von Hand umwandeln, bei vielen Zeilen passieren aber schnell Fehler. Unten können Sie ein Tool direkt ausprobieren, das dieselben Regeln anwendet: Sie fügen Ihre Tabelle einfach ein und sehen gleichzeitig die beiden anderen Formate.
Fügen Sie Ihre Markdown-Tabelle, Ihre HTML-Tags oder Ihre JSON-Daten in das Eingabefeld ein und sehen Sie sofort die Tabellendaten in den anderen Formaten.

Typische Stolperstellen
| Situation | Tatsächliche Verarbeitung |
|---|---|
In der zweiten Markdown-Zeile fehlt die Trennzeile (-) | Die Zeile wird nicht als Trennzeile erkannt und landet unverändert als eine Datenzeile in der Tabelle |
| Die Zeilen haben unterschiedlich viele Zellen | Hat eine Zeile weniger Zellen als die Kopfzeile, wird mit leeren Zeichenketten aufgefüllt; hat sie mehr, wird der Überschuss verworfen |
Das HTML trennt Kopfzeile (<th>) und Inhaltszeilen (<td>) | Die Kopfzeile wird korrekt erkannt, das <tr> mit den Headern kann aber zusätzlich noch einmal als erste Datenzeile auftauchen. Prüfen Sie daher, ob die erste Zeile des Ergebnisses denselben Text wie die Kopfzeile enthält |
| Die Objekte im JSON-Array haben unterschiedliche Schlüssel | Nur die Schlüssel des ersten Objekts bilden die Kopfzeile. Werte von Schlüsseln, die nur in anderen Objekten vorkommen, werden im Ergebnis nicht berücksichtigt |
Fazit
Die drei Formate bilden dieselbe Struktur aus „Kopfzeile + Wertzeilen“ lediglich mit unterschiedlicher Syntax ab. Auch bei der Umwandlung von Hand genügt es, diese Zuordnungsregeln einzuhalten. Der Konverter wendet sie bei jeder Eingabe automatisch an und zeigt Ihnen das Ergebnis. Bei den Punkten, an denen es in der Praxis häufig hakt – fehlende Trennzeile, abweichende Spaltenanzahl, doppelte HTML-Kopfzeile –, sollten Sie das Ergebnis anhand der obigen Tabelle aber einmal mit eigenen Augen prüfen.
Fügen Sie Ihre Markdown-Tabelle, Ihre HTML-Tags oder Ihre JSON-Daten in das Eingabefeld ein und sehen Sie sofort die Tabellendaten in den anderen Formaten.
Häufig gestellte Fragen
Darf die Tabelle verbundene Zellen (rowspan/colspan) enthalten?
Alle drei Formate kennen nur „Kopfzeile + Wertzeilen“, daher werden verbundene Zellen nicht unterstützt. Heben Sie die Verbindung auf und tragen Sie in jede Zelle einen Wert ein, bevor Sie die Tabelle eingeben.
Was tun, wenn im Ergebnis der Inhalt der Kopfzeile noch einmal auftaucht?
Wenn die HTML-Eingabe ein separates <tr> mit <th> für die Kopfzeile enthält, kann diese Zeile zusätzlich noch einmal als Datenzeile übernommen werden (siehe Tabelle oben). Löschen Sie diese Zeile einfach aus dem Ergebnis.
Dürfen Zeilenumbrüche oder das Zeichen | in einer Zelle stehen?
In Markdown ist | selbst das Trennzeichen zwischen den Zellen. Steht ein Pipe-Zeichen in einer Zelle, wird die Tabelle falsch aufgeteilt. Auch ein Zeilenumbruch wird als neue Zeile interpretiert und zerstört die Tabelle, daher sollten Sie ihn in Werten besser vermeiden.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen