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

3
3

                    
                

Markdown Tabellen Syntax

Eine Markdown Tabelle verwendet senkrechte Striche (|) und Bindestriche (-), um Spalten und Zeilen zu definieren:

NameRoleLocation
AliceEngineerBerlin
BobDesignerTokyo
CharliePMNew 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-alignedCenter-alignedRight-aligned
TextTextText
More textMore text1,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:

FeatureStatusNotes
Dark modeDoneShipped in v1.3
Export PDFCancelledUse Cmd+Shift+E instead
SearchIn progressTracking 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 — ![alt](url) (die Größe von Bildern in Tabellen lässt sich allerdings schwer steuern)

In Standard-Markdown Tabellen nicht unterstützt:

  • Überschriften (#)
  • Zitatblöcke (>)
  • Listen (- oder 1.)
  • 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:

CommandDescription
a | bLogical 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:

NameRole
AliceEngineer
BobDesigner
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

  
AliceEngineer
BobDesigner
|       |          |
|-------|----------|
| 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?

MethodeAm besten fürGitHub?
Leere KopfzellenSchnelle & portable Lösung✓
HTML <table>Wirklich ohne Kopfzeile, semantisches HTML✓*
CSS ausblendenDoku-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:

ToolFeatures
MDViewer• GFM tables
• Mermaid diagrams
• Syntax highlighting
TextEdit• Plain text only
| Tool     | Features                                                    |
|----------|-------------------------------------------------------------|
| MDViewer | &bull; GFM tables<br>&bull; Mermaid diagrams<br>&bull; Syntax highlighting |
| TextEdit | &bull; 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:

MethodProsCons
Native appFast launch
Low memory
macOS only
VS CodeExtensions
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:

FeatureSupport
FreePro
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:

CategoryItemStatus
FrontendReact appDone
CSS refactorIn progress
BackendAPI v2Done
Database migrationPlanned
<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

PlattformColspanRowspanHinweise
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

FeatureFreePro
Basic editing✓✓
Export to PDF✗✓
API access✗✓
| Feature       | Free | Pro  |
|---------------|:----:|:----:|
| Basic editing | ✓    | ✓    |
| Export to PDF | ✗    | ✓    |
| API access    | ✗    | ✓    |

Installations- / Plattform-Tabelle

PlatformInstall CommandMin Version
macOSbrew install myapp13.0+
Linuxapt install myappUbuntu 22.04+
Windowswinget install myappWindows 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

MethodEndpointDescription
GET/api/usersList all users
POST/api/usersCreate a user
DELETE/api/users/:idDelete 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

ActionmacOSWindows / Linux
Save⌘SCtrl+S
Find⌘FCtrl+F
Toggle preview⌘Shift+PCtrl+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

PlattformPipe-TabellenHTML-TabellenColspan/RowspanZeilenumbrü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:

AufgabeSyntax
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.

MDViewer herunterladen

Erfordert macOS 13.0 oder neuer. Intel und Apple Silicon.