Markdown Tabellen — Syntax-Anleitung mit Beispielen
Tabellen in Markdown erstellen, formatieren und ausrichten — für GitHub README und Dokumentation
Eine Markdown Tabelle ist ein strukturiertes Datenraster, das mit senkrechten Strichen (Pipes, |) und Bindestrichen (-) erstellt wird. Tabellen wurden mit GitHub Flavored Markdown (GFM) eingeführt und werden heute von praktisch jedem Markdown-Renderer unterstützt — GitHub, GitLab, VS Code, Obsidian und statischen Seitengeneratoren wie Jekyll und Hugo. Unten finden Sie die vollständige Syntax, Beispiele zum Kopieren und Lösungen für Sonderfälle wie Colspan, Rowspan und mehrzeilige Zellen.
Tabellen-Generator
Markdown Tabellen Syntax
Eine Markdown Tabelle verwendet senkrechte Striche (|) und Bindestriche (-), um Spalten und Zeilen zu definieren:
| Name | Role | Location |
|---|---|---|
| Alice | Engineer | Berlin |
| Bob | Designer | Tokyo |
| Charlie | PM | New York |
| Name | Role | Location |
|---------|------------|-----------|
| Alice | Engineer | Berlin |
| Bob | Designer | Tokyo |
| Charlie | PM | New York |
Regeln:
- Die erste Zeile ist immer die Kopfzeile
- Die zweite Zeile (mit Bindestrichen) trennt die Kopfzeile von den Daten
- Jede Spalte wird durch eine Pipe
|getrennt - Pipes am Anfang und am Ende sind optional, verbessern aber die Lesbarkeit
- Die Spalten müssen im Quelltext nicht perfekt ausgerichtet sein — der Renderer übernimmt die Abstände
Spaltenausrichtung
Die Textausrichtung jeder Spalte steuern Sie mit Doppelpunkten (:) in der Trennzeile:
| Left-aligned | Center-aligned | Right-aligned |
|---|---|---|
| Text | Text | Text |
| More text | More text | 1,234.56 |
| Left-aligned | Center-aligned | Right-aligned |
|:-------------|:--------------:|--------------:|
| Text | Text | Text |
| More text | More text | 1,234.56 |
:---oder---— linksbündig (Standard):---:— zentriert---:— rechtsbündig
Rechtsbündige Ausrichtung eignet sich für numerische Spalten — Preise, Anzahlen, Prozentwerte. Zentrierung passt gut zu Statusanzeigen oder kurzen Bezeichnungen.
Formatierung in Tabellen
In Tabellenzellen können Sie Inline-Markdown-Formatierung verwenden:
| Feature | Status | Notes |
|---|---|---|
| Dark mode | Done | Shipped in v1.3 |
| Export PDF | Use Cmd+Shift+E instead | |
| Search | In progress | Tracking issue |
| Feature | Status | Notes |
|------------|-----------------|---------------------------|
| Dark mode | **Done** | Shipped in v1.3 |
| Export PDF | ~~Cancelled~~ | Use `Cmd+Shift+E` instead |
| Search | *In progress* | [Tracking issue](#) |
Unterstützte Formatierungen:
- Fett —
**text** - Kursiv —
*text* Code—`text`Durchgestrichen—~~text~~- Links —
[text](url) - Bilder —
(die Größe von Bildern in Tabellen lässt sich allerdings schwer steuern)
In Standard-Markdown Tabellen nicht unterstützt:
- Überschriften (
#) - Zitatblöcke (
>) - Listen (
-oder1.) - Mehrzeilige Inhalte (jede Zelle muss in einer Zeile stehen)
- Zellen verbinden (Rowspan/Colspan)
Pipe-Zeichen in Tabellen escapen
Wenn der Zelleninhalt ein Pipe-Zeichen enthält, escapen Sie es mit einem Backslash:
| Command | Description |
|---|---|
a | b | Logical OR |
grep "error" | Search for errors |
| Command | Description |
|-----------------|-----------------------|
| `a \| b` | Logical OR |
| `grep "error"` | Search for errors |
Ohne den Backslash würde die Pipe als Spaltentrenner interpretiert.
Minimale Tabellen
Sehr kompakte Tabellen sind möglich, wenn die Lesbarkeit im Quelltext keine Rolle spielt:
| Name | Role |
|---|---|
| Alice | Engineer |
| Bob | Designer |
Name|Role
-|-
Alice|Engineer
Bob|Designer
Das ist gültiges Markdown und wird genauso dargestellt. Ausgerichtete Tabellen sind in Quelldateien jedoch deutlich leichter zu lesen und zu pflegen.
Markdown Tabelle ohne Kopfzeile
Standard-Markdown verlangt eine Kopfzeile — mit der Syntax aus senkrechten Strichen und Bindestrichen lässt sich keine Tabelle ohne Kopfzeile erstellen. Die erste Zeile wird immer als Kopfzeile behandelt, und die Trennzeile (|---|) ist Pflicht.
Wenn Sie eine Tabelle ohne sichtbare Kopfzeile brauchen, helfen diese Workarounds:
Leere Kopfzellen
| Alice | Engineer |
| Bob | Designer |
| | |
|-------|----------|
| Alice | Engineer |
| Bob | Designer |
Dadurch entsteht eine Tabelle mit leer wirkender Kopfzeile. Die Kopfzeile existiert im HTML weiterhin, erscheint aber leer. Die meisten Renderer (auch GitHub) verarbeiten das korrekt.
HTML-Tabelle ohne Kopfzeile
Für eine wirklich kopfzeilenlose Tabelle verwenden Sie reines HTML:
<table>
<tr><td>Alice</td><td>Engineer</td></tr>
<tr><td>Bob</td><td>Designer</td></tr>
</table>
So erhalten Sie eine saubere Tabelle ganz ohne Kopfzeile. Funktioniert auf GitHub, GitLab und in jedem Renderer, der Inline-HTML unterstützt.
Kopfzeile per CSS ausblenden
Wenn Sie die Rendering-Umgebung kontrollieren (eine Website, ein Wiki oder eine Dokumentationsplattform), können Sie die Kopfzeile optisch ausblenden und im Markdown-Quelltext behalten:
<style>
.no-header thead { display: none; }
</style>
| | |
|-----|----------|
| Alice | Engineer |
| Bob | Designer |
{: .no-header }
Die Attribut-Syntax {: .no-header } funktioniert in kramdown (Jekyll, GitHub Pages). Für andere Renderer binden Sie die Tabelle in ein <div class="no-header"> ein und sprechen es per CSS an. In einfachen GitHub-README-Dateien funktioniert dieser Ansatz nicht, da GitHub eigene Styles entfernt.
Welcher Workaround ist der richtige?
| Methode | Am besten für | GitHub? |
|---|---|---|
| Leere Kopfzellen | Schnelle & portable Lösung | ✓ |
| HTML <table> | Wirklich ohne Kopfzeile, semantisches HTML | ✓* |
| CSS ausblenden | Doku-Seiten, Jekyll, Wikis | ✗ |
* HTML-Tabellen funktionieren in GitHub-Repository-Dateien, werden in Issues und Kommentaren aber möglicherweise entfernt.
Listen und verschachtelte Inhalte in Zellen
Standard-Markdown Tabellen unterstützen keine Block-Elemente wie Listen, Zitatblöcke oder Absätze in Zellen. Jede Zelle ist auf eine einzelne Zeile mit Inline-Inhalt beschränkt.
Dafür gibt es zwei Lösungen:
Zeilenumbrüche mit <br>
Eine Liste lässt sich mit Zeilenumbrüchen und Aufzählungszeichen nachbilden:
| Tool | Features |
|---|---|
| MDViewer | • GFM tables • Mermaid diagrams • Syntax highlighting |
| TextEdit | • Plain text only |
| Tool | Features |
|----------|-------------------------------------------------------------|
| MDViewer | • GFM tables<br>• Mermaid diagrams<br>• Syntax highlighting |
| TextEdit | • Plain text only |
HTML-Tabelle mit echten Listen
Für echte verschachtelte Listen verwenden Sie HTML:
<table>
<tr>
<th>Tool</th>
<th>Features</th>
</tr>
<tr>
<td>MDViewer</td>
<td>
<ul>
<li>GFM tables</li>
<li>Mermaid diagrams</li>
<li>Syntax highlighting</li>
</ul>
</td>
</tr>
</table>
HTML-Tabellen mit Listen funktionieren auf GitHub-Repository-Seiten, werden in Issues und Kommentaren aber möglicherweise entfernt. Um schnell zu prüfen, wie Ihre Tabelle dargestellt wird, öffnen Sie die .md-Datei in einem Markdown-Viewer.
Mehrzeilige Zellen
Standard-Markdown Tabellen unterstützen keine Zeilenumbrüche innerhalb von Zellen. Jede Zelle muss in einer einzigen Zeile stehen. Für mehrere Zeilen in einer Zelle verwenden Sie ein HTML-<br>-Tag:
| Method | Pros | Cons |
|---|---|---|
| Native app | Fast launch Low memory | macOS only |
| VS Code | Extensions Built-in terminal | Slow startup Heavy |
| Method | Pros | Cons |
|------------|-------------------------------|-----------------------|
| Native app | Fast launch<br>Low memory | macOS only |
| VS Code | Extensions<br>Built-in terminal | Slow startup<br>Heavy |
<br>-Tags funktionieren auf GitHub, GitLab und in den meisten Markdown-Renderern. Einige strikte Parser unterstützen sie nicht — testen Sie das, bevor Sie sich in produktiver Dokumentation darauf verlassen.
Rowspan und Colspan in Markdown
Standard-Markdown Tabellen unterstützen kein Verbinden von Zellen — es gibt keine native Rowspan- oder Colspan-Syntax. Jede Zeile muss dieselbe Anzahl von Spalten haben.
Wenn Sie verbundene Zellen benötigen (Spalten verbinden bzw. Zeilen verbinden), verwenden Sie statt der Markdown-Tabellensyntax Inline-HTML:
<table>
<tr>
<th>Name</th>
<th colspan="2">Contact</th>
</tr>
<tr>
<td>Alice</td>
<td>alice@example.com</td>
<td>+1 555-0100</td>
</tr>
<tr>
<td rowspan="2">Team B</td>
<td>bob@example.com</td>
<td>+1 555-0200</td>
</tr>
<tr>
<td>charlie@example.com</td>
<td>+1 555-0300</td>
</tr>
</table>
Wichtig: GitHub entfernt in bestimmten Kontexten (Issues, Kommentare) einige HTML-Tabellenattribute. HTML-Tabellen funktionieren zuverlässig in .md-Dateien in der Repository-Ansicht. Für maximale Kompatibilität bleiben Sie bei flachen Markdown Tabellen ohne verbundene Zellen.
Colspan-Beispiel — eine Überschrift über mehrere Spalten
Ein typischer Anwendungsfall ist eine Gruppenüberschrift, die mehrere Spalten umfasst — zum Beispiel, um zusammengehörige Spalten unter einer Bezeichnung zusammenzufassen:
| Feature | Support | |
|---|---|---|
| Free | Pro | |
| Markdown preview | ✓ | ✓ |
| Mermaid diagrams | ✓ | ✓ |
| Git history | ✗ | ✓ |
| PDF export | ✗ | ✓ |
<table>
<tr>
<th>Feature</th>
<th colspan="2" style="text-align:center">Support</th>
</tr>
<tr>
<td></td>
<td><strong>Free</strong></td>
<td><strong>Pro</strong></td>
</tr>
<tr><td>Markdown preview</td><td>✓</td><td>✓</td></tr>
<tr><td>Git history</td><td>✗</td><td>✓</td></tr>
<tr><td>PDF export</td><td>✗</td><td>✓</td></tr>
</table>
Rowspan-Beispiel — Zeilen nach Kategorie gruppieren
Rowspan verbindet Zellen vertikal. So gruppieren Sie zusammengehörige Zeilen, ohne die Kategoriebezeichnung zu wiederholen:
| Category | Item | Status |
|---|---|---|
| Frontend | React app | Done |
| CSS refactor | In progress | |
| Backend | API v2 | Done |
| Database migration | Planned |
<table>
<tr><th>Category</th><th>Item</th><th>Status</th></tr>
<tr>
<td rowspan="2"><strong>Frontend</strong></td>
<td>React app</td><td>Done</td>
</tr>
<tr><td>CSS refactor</td><td>In progress</td></tr>
<tr>
<td rowspan="2"><strong>Backend</strong></td>
<td>API v2</td><td>Done</td>
</tr>
<tr><td>Database migration</td><td>Planned</td></tr>
</table>
Colspan- & Rowspan-Unterstützung nach Plattform
| Plattform | Colspan | Rowspan | Hinweise |
|---|---|---|---|
| GitHub (.md-Dateien) | ✗ | ✗ | In Issues/PRs entfernt; in Repository-Dateien teilweise funktionsfähig |
| GitLab | ✓ | ✓ | Volle HTML-Tabellen-Unterstützung |
| VS Code Vorschau | ✓ | ✓ | Volle Unterstützung über HTML |
| MDViewer | ✓ | ✓ | Volle Unterstützung über HTML |
| Obsidian | ✗ | ✗ | HTML-Tabellen werden ohne Merge-Attribute dargestellt |
Wenn Ihre Leser GitHub nutzen, vermeiden Sie Colspan und Rowspan — wiederholen Sie stattdessen die Daten oder strukturieren Sie die Tabelle als flache Zeilen. Für GitLab, VS Code und Markdown-Viewer für den Desktop werden HTML-Tabellen mit verbundenen Zellen korrekt dargestellt.
README Tabellen-Vorlagen für GitHub
README-Dateien auf GitHub verwenden Tabellen häufig für Feature-Listen, Badges, Installationsanleitungen und API-Dokumentation. Hier finden Sie Vorlagen zum direkten Kopieren. Weitere README-Muster zeigt unsere Anleitung zur README.md-Vorlage.
Feature-Vergleichstabelle
| Feature | Free | Pro |
|---|---|---|
| Basic editing | ✓ | ✓ |
| Export to PDF | ✗ | ✓ |
| API access | ✗ | ✓ |
| Feature | Free | Pro |
|---------------|:----:|:----:|
| Basic editing | ✓ | ✓ |
| Export to PDF | ✗ | ✓ |
| API access | ✗ | ✓ |
Installations- / Plattform-Tabelle
| Platform | Install Command | Min Version |
|---|---|---|
| macOS | brew install myapp | 13.0+ |
| Linux | apt install myapp | Ubuntu 22.04+ |
| Windows | winget install myapp | Windows 10+ |
| Platform | Install Command | Min Version |
|----------|--------------------------|----------------|
| macOS | `brew install myapp` | 13.0+ |
| Linux | `apt install myapp` | Ubuntu 22.04+ |
| Windows | `winget install myapp` | Windows 10+ |
API-Endpunkt-Tabelle
| Method | Endpoint | Description |
|---|---|---|
GET | /api/users | List all users |
POST | /api/users | Create a user |
DELETE | /api/users/:id | Delete a user |
| Method | Endpoint | Description |
|----------|------------------|----------------|
| `GET` | `/api/users` | List all users |
| `POST` | `/api/users` | Create a user |
| `DELETE` | `/api/users/:id` | Delete a user |
Tastenkürzel-Tabelle
| Action | macOS | Windows / Linux |
|---|---|---|
| Save | ⌘S | Ctrl+S |
| Find | ⌘F | Ctrl+F |
| Toggle preview | ⌘Shift+P | Ctrl+Shift+P |
| Action | macOS | Windows / Linux |
|----------------|----------------|------------------|
| Save | `⌘S` | `Ctrl+S` |
| Find | `⌘F` | `Ctrl+F` |
| Toggle preview | `⌘Shift+P` | `Ctrl+Shift+P` |
GitHub Markdown Tabellen
GitHub verwendet überall die GFM-Tabellenspezifikation (GitHub Flavored Markdown) — in README-Dateien, Issues, Pull Requests, Discussions und Wiki-Seiten. Die auf dieser Seite beschriebene Syntax mit senkrechten Strichen und Bindestrichen ist alles, was Sie brauchen.
Was auf GitHub funktioniert
- Standard-Pipe-Tabellen mit Ausrichtung (die Syntax dieser Seite)
- Inline-Formatierung: fett, kursiv,
Code,durchgestrichen, Links <br>für Zeilenumbrüche in Zellen- HTML-Tabellen (nur in Repository-Dateien — in Issues/Kommentaren werden sie entfernt)
Was auf GitHub nicht funktioniert
- colspan / rowspan — der Markdown-Prozessor von GitHub entfernt diese Attribute aus HTML-Tabellen in den meisten Kontexten
- Verschachtelte Listen in Zellen — verwenden Sie stattdessen
<br>mit Aufzählungszeichen (•) - Tabellenüberschriften (Captions) — keine native Unterstützung; als Workaround setzen Sie eine fette Zeile über die Tabelle
- Hintergrundfarben von Zellen — CSS wird entfernt; nutzen Sie stattdessen Emoji oder Textmarkierungen
Tabellen-Unterstützung im Plattformvergleich
| Plattform | Pipe-Tabellen | HTML-Tabellen | Colspan/Rowspan | Zeilenumbrüche |
|---|---|---|---|---|
| GitHub | ✓ | ✓* | ✗ | ✓ |
| GitLab | ✓ | ✓ | ✓ | ✓ |
| VS Code Vorschau | ✓ | ✓ | ✓ | ✓ |
| Obsidian | ✓ | ✓ | ✗ | ✓ |
| MDViewer | ✓ | ✓ | ✓ | ✓ |
| Notion | ✗ | ✗ | Eigenes Format | ✓ |
* GitHub erlaubt HTML-Tabellen in .md-Dateien im Repository, entfernt aber die meisten HTML-Tags aus Issues, Kommentaren und Discussions.
Tabellen in GitHub Pull Requests und Issues
Tabellen funktionieren in GitHub-PR-Beschreibungen, Issue-Texten und Kommentaren — allerdings mit Einschränkungen gegenüber Repository-Dateien:
- Pipe-Tabellen — vollständig unterstützt, dieselbe Syntax wie in README-Dateien
- HTML-Tabellen — GitHub entfernt in Issues/PRs die meisten HTML-Tags, auch
<table>,<tr>und<td>mit Attributen. Verwenden Sie stattdessen die Pipe-Syntax - Ausrichtung — die Doppelpunkt-Syntax funktioniert:
:---:für zentriert,---:für rechtsbündig
Ein gängiges Muster für PR-Beschreibungen:
## Changes
| File | Change | Why |
|----------------|-----------------|---------------------------|
| `api/users.go` | Added `DELETE` | Requested in #142 |
| `db/migrate.go`| Updated schema | New column for soft delete|
| `tests/api_test.go` | Added tests | Coverage for DELETE route |
Wenn Sie für GitHub schreiben (README.md, Issues, PRs), reicht die Standardsyntax dieser Seite völlig aus. Den vollständigen Markdown-Spickzettel — mit Überschriften, Listen, Links und Bildern — finden Sie in unserer ergänzenden Anleitung.
Kurzreferenz — Markdown Tabellen Spickzettel
Diese Muster für die häufigsten Tabellen-Aufgaben können Sie direkt kopieren:
| Aufgabe | Syntax |
|---|---|
| Einfache Tabelle | | A | B | + |---|---| + Datenzeilen |
| Spalte rechtsbündig | |---:| in der Trennzeile |
| Spalte zentriert | |:---:| in der Trennzeile |
| Zellentext fett | | **text** | |
| Code in Zelle | | `code` | |
| Link in Zelle | | [text](url) | |
| Zeilenumbruch in Zelle | | line1<br>line2 | |
| Pipe escapen | | a \| b | |
| Leere Kopfzeile (Workaround ohne Kopfzeile) | | | | als erste Zeile |
| Colspan (nur HTML) | <th colspan="2"> |
| Rowspan (nur HTML) | <td rowspan="2"> |
Diese Syntax funktioniert auf GitHub, GitLab, in VS Code, Obsidian und in jedem GFM-kompatiblen Renderer. Eine umfassendere Übersicht finden Sie in unserem vollständigen Markdown-Spickzettel.
Häufige Fehler
Fehlende Trennzeile:
| Name | Role |
| Alice | Engineer |
Ohne die Zeile |---|---| wird daraus keine Tabelle — sie erscheint als normaler Text mit senkrechten Strichen.
Uneinheitliche Spaltenanzahl:
| Name | Role | Location |
|-------|----------|
| Alice | Engineer | Berlin |
Die Trennzeile hat 2 Spalten, die Kopfzeile aber 3. Die meisten Renderer versuchen es trotzdem, das Ergebnis kann jedoch fehlerhaft aussehen.
Leerzeichen am Zeilenende vor Pipes:
Manche Editoren fügen Leerzeichen am Zeilenende ein, die in strikten Parsern das Rendering stören können. Wenn Ihre Tabelle falsch aussieht, prüfen Sie auf überflüssige Leerzeichen.
Markdown Tabellen-Generatoren & Konverter
Pipes von Hand zu tippen funktioniert bei kleinen Tabellen, wird aber ab etwa 3×3 mühsam. Diese Werkzeuge wandeln vorhandene Daten in Markdown-Tabellensyntax um:
Online-Generatoren
- TableConvert.io — fügen Sie CSV, Excel, JSON oder HTML ein und erhalten Sie Markdown-Ausgabe. Unterstützt Ausrichtungseinstellungen und den Wechsel zwischen Formaten
- Tables Generator (tablesgenerator.com) — visueller Editor mit tabellenkalkulationsähnlicher Oberfläche. Bauen Sie Ihre Tabelle per Klick auf und kopieren Sie dann das Markdown
Kommandozeilen-Tools
- Pandoc — konvertiert zwischen Formaten:
pandoc data.csv -t gfm -o table.md - csvtomd — schlanker CSV-zu-Markdown-Konverter:
csvtomd data.csv
Editor-Integrationen
- VS Code — die Erweiterung Markdown All in One bietet Tabellenformatierung (
Alt+Shift+F) und automatische Vervollständigung von Pipes - MDViewer — zeigt die Darstellung Ihrer Tabelle in Echtzeit beim Tippen. Vergleichen Sie Markdown-Editoren für Mac, um das passende Werkzeug für Ihren Workflow zu finden
Für schnelle einmalige Tabellen ist ein Online-Generator am schnellsten. Für wiederkehrende Konvertierungen (CI-Pipelines, automatisierte Dokumentation) ist Pandoc die Standardwahl.
Markdown Tabellen anzeigen
Rohe Markdown Tabellen in einem Texteditor sind schwer zu lesen, besonders bei vielen Spalten. Ein spezieller Markdown-Viewer stellt sie als sauber formatierte HTML-Tabellen mit Rahmen, Ausrichtung und Styling dar.
MDViewer ist eine native macOS-App, die GitHub Flavored Markdown rendert — einschließlich Tabellen mit Ausrichtung, Inline-Formatierung und Syntax-Hervorhebung. Öffnen Sie eine beliebige .md-Datei im Finder und sehen Sie die Tabelle sofort gerendert. MDViewer stellt außerdem Mermaid-Diagramme und JSON-Dateien mit einer einklappbaren Baumansicht dar.
Wenn .md-Dateien neu für Sie sind, lesen Sie unsere Anleitung, wie Sie Markdown-Dateien auf dem Mac öffnen. Zum Schreiben von Markdown vergleichen Sie die besten Markdown-Editoren für Mac, um das passende Werkzeug zu finden. Lite ist kostenlos; Pro bietet Inline-Bearbeitung, Git-Verlauf und PDF-Export für einmalig $9.99.
FAQ
Wie viele Spalten kann eine Markdown Tabelle haben?
Es gibt kein offizielles Limit. In der Praxis werden mehr als 6–8 Spalten sowohl im Quelltext als auch in der gerenderten Ausgabe schwer lesbar. Für sehr breite Daten ist eine CSV-Datei oder ein spezielles Tabellenwerkzeug die bessere Wahl.
Kann ich in einer Markdown Tabelle Zellen verbinden?
Standard-Markdown unterstützt weder Rowspan noch Colspan. Wenn Sie verbundene Zellen brauchen, verwenden Sie Inline-HTML: <td rowspan="2">. Viele Markdown-Renderer (auch GitHub) entfernen HTML-Tabellen jedoch in bestimmten Kontexten.
Wie erstelle ich eine Markdown Tabelle aus einer Tabellenkalkulation?
Kopieren Sie die Zellen aus Excel oder Google Sheets, fügen Sie sie in TableConvert.io ein und wählen Sie die Markdown-Ausgabe. Alternativ exportieren Sie als CSV und konvertieren mit Pandoc.
Kann ich eine Markdown Tabelle sortieren?
Nicht im Markdown-Quelltext selbst — Tabellen sind statisch. Manche Markdown-Viewer stellen Tabellen mit sortierbaren Spaltenköpfen dar, das ist jedoch kein Standardverhalten.
Kann ich eine Markdown Tabelle ohne Kopfzeile erstellen?
Standard-Markdown verlangt eine Kopfzeile — es gibt keine Syntax für Tabellen ohne Kopfzeile. Als Workaround verwenden Sie leere Kopfzellen (erste Zeile leer lassen) oder eine HTML-<table> ohne <thead>-Element. Beispiele finden Sie im Abschnitt weiter oben.
Wie füge ich eine Liste in eine Markdown-Tabellenzelle ein?
Markdown Tabellen unterstützen keine Block-Elemente wie Listen. Verwenden Sie <br>-Tags mit Aufzählungszeichen (•) für eine optische Liste, oder wechseln Sie zu einer HTML-<table>, in der Sie echte <ul>- oder <ol>-Elemente in <td>-Zellen verschachteln können.
Wie erstelle ich eine Tabelle in einer GitHub README?
Verwenden Sie die Syntax mit senkrechten Strichen (|) und Bindestrichen (-): Beginnen Sie mit einer Kopfzeile, fügen Sie eine Trennzeile mit Bindestrichen hinzu und danach die Datenzeilen. GitHub rendert Standard-GFM-Tabellen automatisch — Erweiterungen sind nicht nötig. Mit Doppelpunkten in der Trennzeile steuern Sie die Ausrichtung. Weitere Beispiele finden Sie in unserer Anleitung zur README-Vorlage.
Wie lautet die Grundsyntax für Markdown Tabellen?
Eine Markdown Tabelle trennt Spalten mit senkrechten Strichen (|) und verwendet Bindestriche (-) für die Trennzeile unter der Kopfzeile. Die erste Zeile ist die Kopfzeile, die zweite Zeile besteht aus Bindestrichen, alle weiteren Zeilen sind Daten. Pipes am Anfang und Ende sind optional, verbessern aber die Lesbarkeit. Ein Beispiel zum Kopieren finden Sie im Abschnitt zur Grundsyntax.
Wie füge ich einen Zeilenumbruch in eine Markdown-Tabellenzelle ein?
Standard-Markdown Tabellen unterstützen keine Zeilenumbrüche. Verwenden Sie ein HTML-<br>-Tag in der Zelle, um einen Umbruch zu erzwingen: Erste Zeile<br>Zweite Zeile. Das funktioniert auf GitHub, GitLab und in den meisten Markdown-Renderern. Beispiele finden Sie im Abschnitt zu mehrzeiligen Zellen.
Wie verwende ich Colspan in einer Markdown Tabelle?
Standard-Markdown kennt keine Colspan-Syntax. Verwenden Sie eine HTML-<table> mit <th colspan="2"> oder <td colspan="2">, um Zellen über mehrere Spalten zu verbinden. Das funktioniert in GitLab, VS Code und Desktop-Markdown-Viewern wie MDViewer, aber GitHub entfernt colspan-Attribute aus HTML-Tabellen in den meisten Kontexten. Code zum Kopieren finden Sie im Abschnitt zu Colspan-Beispielen.
Kann ich eine Markdown Tabelle ohne Kopfzeile verwenden?
Standard-Markdown verlangt eine Kopfzeile — die erste Zeile wird immer als Kopfzeile behandelt. Workarounds: leere Kopfzellen verwenden (Zellen leer lassen), eine reine HTML-<table> ohne <thead> einsetzen oder die Kopfzeile per CSS ausblenden, wo das unterstützt wird. Der Abschnitt zu Tabellen ohne Kopfzeile vergleicht alle drei Ansätze mit Beispielen.
Kann ich eine Tabelle in eine GitHub-PR-Beschreibung einfügen?
Ja. Verwenden Sie die normale Markdown-Tabellensyntax mit senkrechten Strichen und Bindestrichen im PR-Text — dieselbe Syntax wie in README-Dateien. Ausrichtung mit Doppelpunkten und Inline-Formatierung funktionieren ebenfalls. Vermeiden Sie HTML-Tabellen in PRs und Issues, da GitHub die meisten HTML-Tags entfernt. Eine PR-fertige Vorlage finden Sie im Abschnitt zu GitHub-Tabellen.
Wie erstelle ich eine Tabelle in GitHub Markdown?
GitHub verwendet GitHub Flavored Markdown (GFM) Tabellen. Nutzen Sie die Syntax mit senkrechten Strichen und Bindestrichen, optional mit Doppelpunkten für die Ausrichtung. GitHub unterstützt Inline-Formatierung und <br>-Zeilenumbrüche in Zellen, entfernt aber colspan/rowspan-Attribute und die meisten HTML-Tags aus Issues und Kommentaren. HTML-Tabellen funktionieren vollständig in .md-Dateien im Repository. Eine vollständige Kompatibilitätsübersicht finden Sie im Abschnitt zu GitHub Markdown Tabellen.
MDViewer ausprobieren
MDViewer Lite ist kostenlos. Pro bietet Bearbeitung, Git-Verlauf und PDF-Export für $9.99. Laden Sie MDViewer herunter und prüfen Sie, ob es zu Ihrem Workflow passt.
Erfordert macOS 13.0 oder neuer. Intel und Apple Silicon.