Käyttöohje
- Kirjoita otsikko ensimmäiselle riville ja tiedot sen alle tai avaa ”Täytä CSV:stä…” ja liitä soluja taulukkolaskentaohjelmasta.
- Lisää tai poista rivejä ja sarakkeita painikkeilla.
- Aseta kunkin sarakkeen tasaus sen yläpuolella olevasta valikosta.
- Valitse Markdown tai HTML ja kopioi tai lataa taulukko.
Näin se toimii
Markdown-tuloste noudattaa GitHub Flavored Markdownin (GFM) taulukkosyntaksia, jota GitHub, GitLab, monet dokumentaatiogeneraattorit ja useimmat Markdown-editorit tukevat. Ensimmäisestä rivistä tulee otsikkorivi, jota seuraa tasauksen määrittävä erotinrivi: :--- vasemmalle, :---: keskelle, ---: oikealle ja --- oletusarvoisesti.
Solujen sisältö suojataan, jotta se ei voi rikkoa taulukkoa: solussa oleva | kirjoitetaan muodossa \| ja rivinvaihto muuttuu <br>-merkinnäksi, koska GFM-taulukon rivin on pysyttävä yhdellä rivillä. Muu solujen Markdown, kuten **lihavointi** tai `koodi`, säilytetään, ja Markdown-katselin renderöi sen. Kun ”Tasaa sarakkeet välilyönneillä” on käytössä, jokainen sarake täytetään saman levyiseksi, jotta taulukko on luettavissa pelkkänä tekstinä; esimerkiksi kiinalaiset, japanilaiset ja korealaiset merkit lasketaan kahden merkin levyisiksi. Rivit, joissa on vähemmän soluja, täytetään tyhjillä soluilla.
Tuonti hyväksyy sarkaimilla erotetun tekstin (mitä taulukkolaskentaohjelmat laittavat leikepöydälle), CSV-muodon pilkuilla tai puolipisteillä, mukaan lukien lainatut kentät, joissa on pilkkuja, lainausmerkkejä ja rivinvaihtoja, sekä olemassa olevat Markdown-taulukot, joiden tasausrivi luetaan myös.
HTML-tuloste on pelkkä <table>, jossa on <thead> ja <tbody>. Teksti on HTML-suojattu (& < > "), rivinvaihdoista tulee <br>, ja tasaus asetetaan inline text-align -tyyleillä, joten se toimii ilman tyylitiedostoa.
Esimerkit
Laskentataulukosta README-tiedostoon
Valitse alue Google Sheetsissä, kopioi se, liitä se tuontikenttään ja napsauta ”Täytä taulukko”. Aseta hintasarake oikealle tasatuksi ja kopioi Markdown tiedostoon README.md.
Teksti, jossa on pystyviiva
Solu, jossa on ”Unlimited | fair use”, kirjoitetaan muodossa Unlimited \| fair use, joten GitHub näyttää pystyviivan sen sijaan, että aloittaisi uuden sarakkeen.
Olemassa olevan taulukon siistiminen
Liitä käsin kirjoitettu Markdown-taulukko, jossa on epätasaiset välit, napsauta ”Täytä taulukko” ja kopioi tulos takaisin, jolloin kaikki sarakkeet ovat tasattuina ja tasaus säilyy.
Usein kysytyt kysymykset
Voiko solu sisältää rivinvaihdon?
Ei varsinaisena rivinvaihtona, koska jokaisen taulukkorivin on oltava yksi rivi Markdownissa. Generaattori kirjoittaa sen sijaan <br>-merkinnän, jonka GitHub ja useimmat katseluohjelmat näyttävät rivinvaihtona.
Miksi taulukossa on oltava otsikkorivi?
GFM-taulukot alkavat aina otsikkorivillä, jota seuraa tasausrivi. Jos et halua näkyviä otsikoita, voit jättää otsikkosolut tyhjiksi, mutta useimmat katseluohjelmat piirtävät silti otsikkorivin.
Voinko yhdistää soluja?
Ei. Markdown-taulukot eivät tue yhdistettyjä soluja (colspan tai rowspan). Jos tarvitset niitä, käytä HTML-tulostetta ja lisää colspan- tai rowspan-määritteet käsin.
Vaikuttaako täyttö siihen, miltä taulukko näyttää renderöitynä?
Ei. Ylimääräiset välilyönnit ohitetaan, kun Markdown renderöidään. Täyttö vain helpottaa lähdekoodin lukemista ja muokkaamista.
Tietosuoja
Taulukko muodostetaan vain selaimessasi. Kirjoittamiasi tai liittämiäsi tietoja ei ladata, tallenneta eikä sisällytetä analytiikkaan.