Markdown Tabellen: Eine vollständige Anleitung zur GFM Tabellensyntax

Mit Markdown-Tabellen können strukturierte Daten in einem lesbaren Format angezeigt werden, das als HTML-Tabelle dargestellt wird. Dieser Leitfaden umfaßt die vollständigen GFM (GitHub Aromatisiert Markdown) Tabellensyntax, Ausrichtung Optionen, erweiterte Muster, und wie man Word Tabellen in Markdown konvertieren.

Basis-Tabellen-Syntax

Eine Markdown-Tabelle besteht aus drei Teilen:

1. Überschriftzeile Spaltenbezeichnungen
2. Separatorenreihe Schaltflächen mit Rohren, definiert die Tabelle
3. Datenzeilen der Inhalt

| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Row 1, Col 1 | Row 1, Col 2 | Row 1, Col 3 |
| Row 2, Col 1 | Row 2, Col 2 | Row 2, Col 3 |

Darstellungen wie folgt:

Ausrichtung der Spalte

Verwenden Sie Kolonen in der Trennzeile, um die Ausrichtung zu steuern:

| Left aligned | Center aligned | Right aligned |
|:---|:---:|---:|
| text | text | text |
| longer text | longer text | longer text |

• :--- Linke Ausrichtung (Standard)
• :---: Zentrum ausgerichtet
• ---: Rechte Ausrichtung

Formatierung innerhalb von Tabellenzellen

Die meisten Inline Markdown-Formatierungen funktionieren innerhalb von Tabellenzellen:

| Element | Example |
|---|---|
| Bold | **bold text** |
| Italic | *italic text* |
| Code | `inline code` |
| Link | [click here](https://wordtomd.org) |
| Strikethrough | ~~deleted~~ |

Was nicht funktioniert: Mehrzeilen-Inhalte, verschachtelte Listen, Elemente auf Blockebene.

Rohrzeichen in Zellen

Wenn Sie eine buchstäbliche Pfeife brauchen | Innerhalb einer Zelle, entkommt mit einem Backslash:

| Flag | Description |
|---|---|
| `x \| y` | Bitwise OR operator |

Tabellen ohne Abstand

Der Abstand zwischen den Rohren ist optional. Dies gilt:

|Column 1|Column 2|
|---|---|
|Cell|Cell|

Aber ein einheitlicher Abstand macht die Tabellen lesbarer. Die meisten Redakteure und Linter bevorzugen das Abstandsformat.

Leere Zellen

Lassen Sie den Raum zwischen den Rohren für eine leere Zelle leer:

| A | B | C |
|---|---|---|
| content | | content |
| | content | |

Umwandlung von Word Tabellen in Markdown

Word-Tabellen werden automatisch umgewandelt, wenn Sie WordToMD. The converter handles:

• Standardgitter → GFM Rohrtafeln
• Spaltenbreiten → standardisiert (Markdown steuert die Spaltenbreite nicht)
• Textformatierung innerhalb von Zellen → konserviert (fett, kursiv, Links)

Was nicht konvertiert:

• Zusammengefasste Zellen (Spalte/Spalte) zu der nächstgelegenen Zelle zusammengebrochen
• Mehrzeilenzellengehalt Linienunterbrechungen gestrichen
• Eingebettete Tische innerer Tisch abgeflacht

Verarbeitung komplexer Word-Tabellen

Zusammengeschlossene Zellen

Words zusammengefasste Zellen haben kein Markdown-Äquivalent. Optionen:

1. Umstrukturierung Aufgeteilte zusammengefasste Zeilen in getrennte Tabellen
2. Verwenden Sie HTML Die meisten Markdown-Prozessoren akzeptieren die HTML-Tabellen-Syntax:

<table>
  <tr>
    <th colspan="2">Merged Header</th>
  </tr>
  <tr>
    <td>Cell 1</td>
    <td>Cell 2</td>
  </tr>
</table>

Mehrzeilen-Zellinhalt

Gebrauch <br> für Linienunterbrechungen innerhalb von Zellen (wirkt auf GitHub und den meisten Plattformen):

| Step | Description |
|---|---|
| 1 | Open the file<br>Make sure it's .docx format |
| 2 | Drop it on [WordToMD](/#converter) |

Große Tische

Für Tabellen mit vielen Spalten sollten Sie prüfen, ob eine Tabelle das richtige Format ist. Alternativen:

• Eine Definitionsliste (Begriff + Beschreibung)
• Mehrere kleinere Tabellen nach Kategorien
• Ein Code-Block für strukturierte Daten (JSON, YAML)

Tabellendarstellung nach Plattform

Zugänglichkeit

Für eine bessere Zugänglichkeit stellen Sie sicher, dass Tabellen eine Headerzeile mit aussagekräftigen Spaltennamen haben. Bildschirmleser verwenden die Headerzeile, um den Zellkontext anzukündigen.

| Product | Price | Availability |
|---|---|---|
| Widget A | $9.99 | In stock |
| Widget B | $14.99 | Out of stock |

Vermeiden Sie die Verwendung von Tabellen für Layout-Zwecke Verwenden Sie sie nur für tatsächliche Tabellendaten.

FAQ

Warum wird meine Tabelle nicht als einfacher Text angezeigt? Die Separatorreihe (die |---|---| Annahme durch die Kommission am 30. Juni. Ohne sie wird der Parser die Tabellenstruktur nicht erkennen.

Kann ich einen Tisch ohne Kopfzeile haben? Nicht im Standard GFM. Die Kopfzeile und der Trennzeichen sind erforderlich. Wenn Sie keine sichtbare Überschrift wünschen, verwenden Sie eine leere Überschrift: | | | mit einer Trennreihe.

Warum sehen meine Tabellen von Word in WordToMD richtig aus, aber falsch, nachdem ich sie woanders eingefügt habe? Das Problem besteht in der Regel darin, in Zellen oder in inkonsistenten Rohrzeichen Weißräume zu verfolgen. Die meisten Markdown-Renderer sind nachsichtig, aber Copy-Paste kann unsichtbare Zeichen einführen.

Wie erstelle ich eine Tabelle programmatisch aus Daten? Bibliotheken wie markdown-table (npm) oder Pythons tabulate kann Markdown-Tabellen aus Arrays erzeugen. Dies ist nützlich für die Batch-Konvertierung von CSV- oder Datenbankdaten.

Verwandte Leitfäden

• Was ist Markdown? Markdown Grundlagen
• Markdown Syntax Kurzübersicht Vollständige Syntaxbezug
• Wie man Word in Markdown umwandelt Vollständige Umstellungsanleitung
• DOCX bis Markdown mit Tabellen Konzentriert sich auf die Tabellenumwandlung

Schlußfolgerung

Markdown-Tabellen sind leistungsstark für die Darstellung strukturierter Daten und werden auf allen wichtigen Plattformen weitgehend unterstützt. Für Tabellen, die mit Word beginnen, WordToMD konvertiert sie automatisch in GFM-Syntax. Für komplexe Layouts gibt Ihnen das HTML-Fallback und die oben genannten Tricks die nötige Kontrolle.