Sådan bruger du det
- Skriv overskriften i første række og dataene nedenunder, eller åbn “Udfyld fra CSV…” og indsæt celler fra et regneark.
- Tilføj eller fjern rækker og kolonner med knapperne.
- Indstil justeringen af hver kolonne med menuen ovenover den.
- Vælg Markdown eller HTML, og kopier eller download tabellen.
Sådan fungerer det
Markdown-outputtet følger tabelsyntaksen for GitHub Flavored Markdown (GFM), som GitHub, GitLab, mange dokumentationsgeneratorer og de fleste Markdown-editorer understøtter. Den første række bliver til overskriften, efterfulgt af adskillelsesrækken, der angiver justering: :--- for venstre, :---: for centreret, ---: for højre og --- for standard.
Celleindhold maskeres, så det ikke kan ødelægge tabellen: en | inde i en celle skrives som \|, og et linjeskift bliver til <br>, fordi en GFM-tabelrække skal forblive på én linje. Anden Markdown i celler, såsom **fed** eller `kode`, bevares og gengives af Markdown-viseren. Med “Justér kolonner med mellemrum” gøres hver kolonne lige bred, så tabellen er læsbar som ren tekst; tegn som kinesisk, japansk eller koreansk tæller som to kolonner brede. Rækker med færre celler udfyldes med tomme celler.
Importen accepterer tabulatorsepareret tekst (som regneark lægger på udklipsholderen), CSV med kommaer eller semikoloner inklusive citerede felter med kommaer, anførselstegn og linjeskift, samt eksisterende Markdown-tabeller, hvis justeringsrække også læses.
HTML-outputtet er en almindelig <table> med <thead> og <tbody>. Tekst er HTML-escaped (& < > "), linjeskift bliver til <br>, og justering angives med inline text-align-stilarter, så det fungerer uden et stylesheet.
Eksempler
Regneark til README
Vælg et område i Google Sheets, kopier det, indsæt det i importboksen, og klik på “Udfyld tabel”. Indstil priskolonnen til højrejusteret, og kopier Markdown ind i README.md.
Tekst med et pipe-tegn
En celle, der indeholder “Unlimited | fair use”, skrives som Unlimited \| fair use, så GitHub viser pipe-tegnet i stedet for at starte en ny kolonne.
Oprydning af en eksisterende tabel
Indsæt en håndskrevet Markdown-tabel med ujævn afstand, klik på “Udfyld tabel”, og kopier resultatet tilbage med alle kolonner på linje og justeringen bevaret.
Ofte stillede spørgsmål
Kan en celle indeholde et linjeskift?
Ikke som et rigtigt linjeskift, fordi hver tabelrække skal være på én linje i Markdown. Generatoren skriver <br> i stedet, som GitHub og de fleste fremvisere viser som et linjeskift.
Hvorfor skal der være en overskriftsrække?
GFM-tabeller starter altid med en overskriftsrække efterfulgt af justeringsrækken. Hvis du ikke ønsker synlige overskrifter, kan du lade overskriftscellerne være tomme, men de fleste fremvisere tegner stadig overskriftslinjen.
Kan jeg flette celler sammen?
Nej. Markdown-tabeller understøtter ikke sammenflettede celler (colspan eller rowspan). Hvis du har brug for dem, skal du bruge HTML-outputtet og tilføje colspan- eller rowspan-attributter manuelt.
Ændrer den ekstra afstand tabellens udseende, når den gengives?
Nej. Ekstra mellemrum ignoreres, når Markdown gengives. Den ekstra afstand gør kun kilden nemmere at læse og redigere.
Privatliv
Tabellen bygges kun i din browser. De data, du skriver eller indsætter, bliver ikke uploadet, gemt eller inkluderet i analyser.