Utilia
Kategoriat ▾
Kieli: fi ▾

Markdown-taulukkogeneraattori

Tee Markdown-taulukko ruudukossa, liitä CSV tai taulukkolaskennan soluja, valitse tasaus ja kopioi siististi tasattu GitHub-Markdown-taulukko.

Ensimmäinen rivi on otsikkorivi. Siirry Enterillä seuraavalle riville. Liitä taulukkolaskennasta kopioidut solut mihin tahansa soluun, niin ruudukko täyttyy siitä alkaen.

Esikatselu

Tuo dataa

Näin teet Markdown-taulukon

  1. Kirjoita sisältö ruudukkoon. Ensimmäinen rivi on taulukon otsikkorivi.
  2. Muotoile taulukkoa painikkeilla Lisää rivi, Lisää sarake, Poista viimeinen rivi ja Poista viimeinen sarake tai pienillä ×-painikkeilla. Uusi tyhjä taulukko aloittaa alusta 3 × 3 -ruudukolla.
  3. Valitse jokaisen sarakkeen tasaus sen yläpuolella olevasta valikosta: Oletus, Vasen, Keskitetty tai Oikea.
  4. Jätä Tasaa sarakkeet Markdown-lähdekoodissa valituksi, jos haluat taulukon, joka on helppo lukea pelkkänä tekstinä. Poista valinta, jos haluat mahdollisimman lyhyen lähdekoodin.
  5. Kopioi tulos tai lataa se .md-tiedostona. Esikatselu näyttää, miltä taulukko näyttää renderöitynä.

Jos haluat aloittaa olemassa olevasta datasta, liitä se kenttään Tuo dataa, valitse Muoto (tai jätä Tunnista automaattisesti) ja napsauta Tuo. Voit myös liittää Excelistä, LibreOfficesta tai Google Sheetsistä kopioidun solulohkon suoraan mihin tahansa ruudukon soluun: ruudukko kasvaa lohkon kokoiseksi alkaen siitä solusta.

Näin Markdown-taulukot toimivat

Taulukot eivät kuulu alkuperäiseen Markdown-syntaksiin. Ne tulevat GitHub Flavored Markdown (GFM) -määrittelystä, jota tukevat GitHub, GitLab, Bitbucket, useimmat staattiset sivugeneraattorit, Obsidian, Notion-viennit ja monet dokumentaatiotyökalut. GFM-taulukossa on kolme osaa:

  • otsikkorivi, jonka solut erotetaan pystyviivoilla: | Nimi | Pisteet |;
  • erotinrivi, jossa on viivoja yksi solu sarakkeelta: | --- | --- |;
  • mikä tahansa määrä sisältörivejä.

Erotinrivi määrää myös tasauksen. Kaksoispiste vasemmalla (:---) tasaa sarakkeen vasemmalle, kaksoispiste oikealla (---:) oikealle ja kaksoispisteet molemmilla puolilla (:---:) keskittää sen. Ilman kaksoispistettä renderöijä käyttää oletustaan, joka on yleensä vasen tasaus.

GFM:ssä otsikkorivi on pakollinen: taulukkoa ilman sitä ei tunnisteta. Jos datallasi ei ole luontevaa otsikkoa, anna ensimmäiselle riville lyhyet sarakenimet.

Erikoismerkit ja rivinvaihdot

Pystyviiva solun sisällä päättäisi solun, joten tämä työkalu escapettaa sen muotoon \|. Jo escapettua pystyviivaa ei muuteta, joten tulosta ei koskaan escapeteta kahdesti. Markdown-taulukoissa ei myöskään voi olla oikeita rivinvaihtoja: tuodun datan rivinvaihto muuttuu merkiksi <br>, jonka GitHub ja useimmat renderöijät näyttävät rivinvaihtona solun sisällä. Kaikki muu, kuten **lihavointi**, `koodi` ja linkit, säilyy sellaisenaan, joten soluissa voi käyttää rivinsisäistä Markdownia.

Kun sarakkeet tasataan, leveät merkit, kuten kiinan-, japanin- tai korean kieli ja emojit, lasketaan kahden sarakkeen levyisiksi, jotta pystyviivat osuvat kohdakkain tasalevyisessä editorissa.

CSV:n, taulukkolaskennan solujen tai Markdown-taulukon tuonti

Tunnista automaattisesti etsii ensin liitetystä tekstistä Markdown-taulukkoa tasauksineen. Muuten teksti luetaan erotinmerkein jaettuna datana: tabulaattorilla erotettuna, jos ensimmäisellä rivillä on tabulaattori (taulukkolaskenta tallentaa leikepöydälle tällaista), muuten pilkulla, puolipisteellä tai pystyviivalla sen mukaan, mitä esiintyy eniten. Lainausmerkeissä olevat arvot, kuten "Virtanen, Matti", käsitellään CSV:n tapaan. Suomalaisessa Excelissä CSV-tiedoston erotin on usein puolipiste, ja sekin tunnistetaan. Ruudukkoon mahtuu enintään 500 riviä ja 30 saraketta.

Usein kysytyt kysymykset

Lähetetäänkö dataani minnekään?

Ei. Ruudukko, tuonti ja Markdown-tuloste käsitellään tässä työkalussa selaimessasi. Mikään kirjoittamasi tai liittämäsi ei poistu laitteeltasi.

Miksi taulukkoni ei näy oikein sivustollani?

Tarkista, että renderöijäsi tukee GFM-taulukoita ja että taulukon edellä on tyhjä rivi. Jotkin Markdown-moottorit, kuten alkuperäinen Markdown.pl, eivät tue taulukoita lainkaan.

Voinko muokata olemassa olevaa Markdown-taulukkoa?

Voit. Liitä koko taulukko kenttään Tuo dataa ja napsauta Tuo. Solut ja sarakkeiden tasaukset ladataan ruudukkoon valmiina muokattaviksi.

Voiko solussa olla useita rivejä tai lista?

Vain rivinsisäistä sisältöä. Rivinvaihdot muuttuvat merkiksi <br>, mutta lohkoelementit, kuten listat, otsikot tai koodilohkot, eivät ole sallittuja GFM-taulukon soluissa.

Näyttääkö tasattu versio erilaiselta renderöitynä?

Ei. Ylimääräiset välilyönnit vain helpottavat lähdekoodin lukemista ja tarkastelua muutoshistoriassa. Molemmat versiot renderöityvät samaksi taulukoksi.

Aiheeseen liittyvät työkalut