Markdown-tabelgenerator

Zo maak je een Markdown-tabel

1. Typ je inhoud in het raster. De eerste rij is de kop van de tabel.
2. Gebruik Rij toevoegen, Kolom toevoegen, Laatste rij verwijderen en Laatste kolom verwijderen, of de kleine ×-knoppen, om de tabel vorm te geven. Met Nieuwe lege tabel begin je opnieuw met een raster van 3 × 3.
3. Kies de uitlijning van elke kolom in het menu erboven: Standaard, Links, Gecentreerd of Rechts.
4. Laat Kolommen uitlijnen in de Markdown-broncode aangevinkt voor een tabel die ook als platte tekst goed leesbaar is, of vink het uit voor de kortst mogelijke broncode.
5. Kopieer het resultaat of download het als .md-bestand. Het Voorbeeld laat zien hoe de tabel eruitziet als hij wordt weergegeven.

Wil je beginnen met bestaande gegevens, plak ze dan in Gegevens importeren, kies een Formaat (of laat Automatisch herkennen staan) en klik op Importeren. Je kunt ook een blok cellen dat je uit Excel, LibreOffice of Google Sheets hebt gekopieerd rechtstreeks in een cel van het raster plakken: het raster groeit mee met het blok, vanaf die cel.

Hoe Markdown-tabellen werken

Tabellen horen niet bij de oorspronkelijke Markdown-syntaxis. Ze komen uit de specificatie van GitHub Flavored Markdown (GFM), die wordt ondersteund door GitHub, GitLab, Bitbucket, de meeste statische sitegenerators, Obsidian, Notion-exports en veel documentatietools. Een GFM-tabel bestaat uit drie delen:

• een koprij, met cellen gescheiden door verticale strepen (pipes): | Naam | Score |;
• een scheidingsrij van streepjes, één cel per kolom: | --- | --- |;
• een willekeurig aantal gewone rijen.

De scheidingsrij bepaalt ook de uitlijning. Een dubbele punt links (:---) lijnt de kolom links uit, een dubbele punt rechts (---:) lijnt rechts uit en dubbele punten aan beide kanten (:---:) centreren de kolom. Zonder dubbele punt gebruikt de renderer zijn standaard, meestal links.

Een kop is verplicht in GFM: een tabel zonder kop wordt niet herkend. Hebben je gegevens geen logische kop, geef de eerste rij dan korte kolomnamen.

Speciale tekens en regeleinden

Een pipe in een cel zou de cel afsluiten, dus deze tool schrijft hem als \|. Een pipe die al ge-escapet is, blijft ongemoeid, zodat de uitvoer nooit dubbel ge-escapet wordt. Echte regeleinden kunnen evenmin in een Markdown-tabel: een regeleinde in geïmporteerde gegevens wordt <br>, wat GitHub en de meeste renderers als een nieuwe regel binnen de cel tonen. Al het andere, zoals **vet**, `code` en links, blijft zoals je het typt, dus je kunt inline Markdown in cellen gebruiken.

Bij uitgelijnde kolommen tellen brede tekens, zoals Chinese, Japanse of Koreaanse tekst en emoji, als twee kolommen, zodat de pipes in een editor met vaste letterbreedte netjes onder elkaar staan.

CSV, spreadsheetcellen of een Markdown-tabel importeren

Automatisch herkennen zoekt eerst naar een Markdown-tabel ergens in de geplakte tekst, inclusief uitlijning. Anders wordt de tekst gelezen als gescheiden gegevens: door tabs gescheiden als de eerste regel een tab bevat (wat spreadsheets op het klembord zetten), anders komma, puntkomma of pipe, afhankelijk van wat het vaakst voorkomt. Waarden tussen aanhalingstekens zoals "Jansen, Jr." worden behandeld zoals in CSV. Handig voor Nederlandse en Belgische Excel-exports, die vaak een puntkomma als scheidingsteken gebruiken. Het raster bevat maximaal 500 rijen en 30 kolommen.