In dit artikel
Wat zijn Markdown-tabellen?
Markdown-tabellen gebruiken pijptekens (|) en koppeltekens (-) om gestructureerde tabelgegevens te maken in platte tekstdocumenten. Ze maken deel uit van GitHub Flavored Markdown (GFM) en worden ondersteund door de meeste Markdown-renderers, waaronder GitHub, GitLab, VS Code en statische sitegeneratoren.
Tabellen in Markdown zijn ontworpen voor eenvoudige datapresentatie — kolomkoppen, scheidingsrij en gegevensrijen. Ze worden weergegeven als correcte HTML-tabellen in de uitvoer, waardoor ze ideaal zijn voor documentatie, README-bestanden en technisch schrijven zonder HTML-kennis.
Markdown-tabelsyntaxis
Een Markdown-tabel bestaat uit drie delen: de koprij, de scheidingsrij en één of meer gegevensrijen.
- Koprij — de eerste rij definieert kolomnamen, gescheiden door pijptekens (|). Voorloopende en afsluitende pijptekens zijn optioneel maar aanbevolen voor de duidelijkheid.
- Scheidingsrij — de tweede rij gebruikt koppeltekens (---) tussen pijptekens om de koptekst van de gegevens te scheiden. Er zijn minimaal drie koppeltekens per kolom vereist.
- Gegevensrijen — elke volgende rij bevat celwaarden gescheiden door pijptekens. Cellen hoeven niet visueel uitgelijnd te zijn, hoewel uitgelijnde kolommen de leesbaarheid van de broncode verbeteren.
- Pijptekens escapen — als celinhoud een letterlijk pijpteken bevat, escapet u het met een backslash (\|) om te voorkomen dat het wordt geïnterpreteerd als een kolomscheidingsteken.
Kolomuitlijningsopties
Kolomuitlijning wordt bepaald door dubbele punten toe te voegen aan de scheidingsrij. Dit bepaalt hoe tekst binnen elke kolom wordt uitgelijnd.
- Links uitlijnen (standaard) — gebruik :--- of --- in het scheidingsteken. Tekst lijnt uit naar de linkerrand van de kolom. Dit is de standaard wanneer geen dubbele punten zijn opgegeven.
- Centreren — gebruik :---: in het scheidingsteken. Tekst wordt gecentreerd in de kolom. Handig voor statuslabels, categorieën of korte waarden.
- Rechts uitlijnen — gebruik ---: in het scheidingsteken. Tekst lijnt uit naar de rechterrand. Ideaal voor numerieke waarden, prijzen, tellingen en metingen.
Probeer gratis — geen aanmelding vereist
Markdown-tabellen genereren →Veelvoorkomende gebruiksscenario's
Markdown-tabellen worden gebruikt overal waar gestructureerde gegevens in documentatie moeten worden gepresenteerd.
- README-documentatie — tabellen voor het vergelijken van projectfuncties, installatievereisten, ondersteunde platforms en versiecompatibiliteitsmatrices
- API-documentatie — eindpuntreferenties met methode, pad, beschrijving en parametertabellen voor elke route
- Vergelijkingstabellen — functievergelijkingen naast elkaar, prijsniveaus en gereedschapsevaluaties in blogberichten en technische beoordelingen
- Wijzigingslogboeken — versiegeschiedenistabellen met datum, versienummer en beschrijving van wijzigingen voor elke release
Tips en best practices
Het volgen van deze richtlijnen helpt uw Markdown-tabellen leesbaar te houden in zowel de bronvorm als de weergegeven vorm.
- Houd kolommen uitgelijnd in de bron — vul cellen op met spaties zodat kolommen visueel op één lijn staan. De meeste editors en onze generator doen dit automatisch. Uitgelijnde bron is veel gemakkelijker te beoordelen in pull requests.
- Vermijd complexe inhoud in cellen — Markdown-tabellen ondersteunen geen meerregelige celinhoud, blokelementen of geneste tabellen. Houd celinhoud kort en eenvoudig. Voor complexe gegevens kunt u in plaats daarvan HTML-tabellen gebruiken.
- Beperk het aantal kolommen — tabellen met meer dan 5-6 kolommen worden moeilijk leesbaar op kleinere schermen. Overweeg brede tabellen te splitsen in meerdere gerichte tabellen of een ander formaat te gebruiken voor zeer brede gegevens.
Veelgestelde vragen
Is er een limiet aan celinhoud in Markdown-tabellen?
Er is geen technische tekenlimiet voor celinhoud, maar Markdown-tabelcellen zijn alleen één-regelig. U kunt geen regeleinden, alinea's of elementen op blokniveau zoals lijsten in een cel opnemen. Voor complexe celinhoud gebruikt u HTML-tabellen met <td>-elementen die elke HTML-inhoud ondersteunen.
Kan ik cellen samenvoegen in Markdown-tabellen?
Nee. Standaard Markdown-tabellen ondersteunen geen colspan of rowspan — elke rij moet hetzelfde aantal kolommen hebben. Voor het samenvoegen van cellen zijn HTML-tabellen vereist. Als u samengevoegde cellen nodig heeft, schrijft u de tabel in HTML en integreert u deze direct in uw Markdown-document.
Kan ik tabellen nesten binnen Markdown-tabellen?
Nee. Markdown-tabellen kunnen niet worden genest. Elke tabel is een plat raster van rijen en kolommen. Als u hiërarchische gegevens nodig heeft, overweeg dan geneste lijsten, afzonderlijke tabellen met koppen of HTML-tabellen met geneste <table>-elementen te gebruiken.