Markdown-editori

Tämä verkossa toimiva Markdown-editori näyttää tekstisi vasemmalla ja muotoillun tuloksen oikealla, ja esikatselu päivittyy jokaisella näppäilyllä. Se ymmärtää Markdownia sellaisena kuin sitä käytetään GitHubissa, README-tiedostoissa, wikeissä ja Obsidianin kaltaisissa muistiinpanosovelluksissa: otsikot, luettelot, tarkistuslistat, taulukot, koodin, lainaukset, linkit, kuvat ja alaviitteet. Et tarvitse käyttäjätiliä, eikä mitään kirjoittamaasi lähetetä minnekään.

Näin käytät Markdown-editoria verkossa

1. Kirjoita tai liitä Markdown vasempaan kenttään tai avaa .md-tiedosto työkalurivin tiedostopainikkeella. Voit myös pudottaa tiedoston mihin tahansa kohtaan editoria.
2. Seuraa esikatselua oikealla. Synkronoitu vieritys pitää molemmat puolet samassa kohdassa asiakirjaa, kun vierität kumpaa tahansa.
3. Muotoile tekstiä työkalurivillä tai pikanäppäimillä, kuten Ctrl+B lihavointiin ja Ctrl+K linkkiin.
4. Kopioi tulos Markdownina, HTML:nä tai muotoiltuna tekstinä, tai lataa se .md-, .pdf-, .docx-, .html- tai .txt-tiedostona.

Editori avautuu lyhyellä esimerkillä nimeltä ”Projektin muistiinpanot”. Siinä on kaikki tavalliset elementit, joten näet syntaksin ja sen tuloksen rinnakkain ennen kuin kirjoitat omaa tekstiäsi.

Markdown-editori reaaliaikaisella esikatselulla

Editorin yläpuolella on kolme näkymää. Rinnakkain näyttää Markdownin ja esikatselun vierekkäin, Kirjoita antaa koko leveyden tekstille ja Esikatselu näyttää vain tuloksen, joten se toimii yksinkertaisena Markdown-katselimena, kun joku lähettää sinulle tiedoston. Puhelimessa editori vaihtaa näkymien Kirjoita ja Esikatselu välillä, koska kahteen sarakkeeseen jaettuna näkymä olisi liian kapea luettavaksi.

Esikatselu näyttää Markdownin samalla tavalla kuin GitHub: pohjana on CommonMark ja sen päällä GitHub Flavored Markdown -laajennukset (molemmat englanniksi), jotka tuovat mukaan taulukot, tarkistuslistat, yliviivauksen ja automaattiset linkit. Otsikot saavat ankkurit kuten GitHubissa, joten otsikkoon ## Julkaisusuunnitelma voi linkittää muodossa #julkaisusuunnitelma, ja tällaisen linkin napsauttaminen vierittää esikatselun otsikon kohdalle. Muodossa [^1] kirjoitetut alaviitteet numeroidaan siinä järjestyksessä, jossa mainitset ne ensimmäisen kerran, ja ne luetellaan lopussa.

Tekstikenttä käyttää selaimesi oikolukua, joten väärin kirjoitetut sanat alleviivataan jo kirjoittaessasi. Editorin alla näet sanojen ja merkkien määrän sekä lukuajan. Laskuissa ei huomioida Markdown-syntaksia, joten ##-merkeillä merkitystä otsikosta lasketaan vain sen sanat. Jos haluat laskea myös lauseet ja kappaleet, liitä teksti merkki- ja sanalaskuriin.

Työkalurivi ja pikanäppäimet

Työkalurivillä on kaikki, mitä tavallinen asiakirja tarvitsee: Otsikko, Lihavointi, Kursivointi, Yliviivaus, Rivinsisäinen koodi, Linkki, Kuva, Lainaus, Koodilohko, Luettelomerkitty luettelo, Numeroitu luettelo, Tarkistuslista, Taulukko ja Vaakaviiva. Valitse ensin tekstiä, niin painike ympäröi sen merkinnöillä; paina samaa painiketta uudelleen, niin merkinnät poistuvat. Ilman valintaa painike lisää lyhyen paikkamerkkitekstin, joka on valmiiksi valittuna, joten voit kirjoittaa suoraan sen päälle.

Muutama yksityiskohta säästää aikaa:

• Otsikko vaihtaa nykyisen rivin vuorotellen muotoihin #, ## ja ### ja sitten takaisin tavalliseksi tekstiksi.
• Linkki muuttaa valitut sanat muotoon [sanat](https://) ja valitsee osoiteosan, joten voit liittää URL-osoitteen saman tien. Jos valitset sen sijaan URL-osoitteen, siitä tulee linkin osoite.
• Luettelopainikkeet ja Lainaus toimivat kaikilla valituilla riveillä kerralla. Kun napsautat Numeroitu luettelo -painiketta luettelomerkityn luettelon kohdalla, siitä tulee numeroitu luettelo.
• Kun painat Enter-näppäintä luettelon kohdan lopussa, seuraava kohta alkaa oikealla merkillä. Numerot kasvavat, uusi tehtävä alkaa valitsemattomana, ja Enter tyhjässä kohdassa lopettaa luettelon. Tab ja Shift+Tab sisentävät luettelon kohtia ja poistavat sisennyksen.
• Jokaisen painikkeella tai pikanäppäimellä tehdyn muutoksen voi kumota näppäimillä Ctrl+Z.

Kaikki pikanäppäimet on lueteltu editorin alla kohdassa Pikanäppäimet. Macissa niissä käytetään Komento-näppäintä.

Liitä Wordista tai Google Docsista, niin saat Markdownia

Kun liität Wordista, Google Docsista tai verkkosivulta kopioitua tekstiä, editori muuntaa sen muotoilun Markdowniksi sen sijaan, että hylkäisi sen. Otsikoista tulee #-rivejä, lihavoitu ja kursivoitu teksti saa tähtimerkkinsä, linkit säilyttävät osoitteensa, luettelomerkityistä ja numeroiduista luetteloista (myös Wordin monitasoisista luetteloista) tulee Markdown-luetteloita, ja taulukoista tulee Markdown-taulukoita, joiden ensimmäinen rivi on otsikkorivi. Näin olemassa olevan asiakirjan saa nopeimmin README-tiedostoon tai wikisivulle.

Jos halusit pelkän tekstin, napsauta liittämisen jälkeen näkyvässä ilmoituksessa Käytä sen sijaan pelkkää tekstiä tai liitä näppäimillä Ctrl+Shift+V. VS Codesta tai muusta koodieditorista kopioitu koodi sekä teksti, joka on jo Markdownia, liitetään täsmälleen sellaisenaan.

Markdown-syntaksin pikaopas

Yleisin syntaksi yhdellä silmäyksellä. Kirjoita vasemman sarakkeen sisältö editoriin, niin näet oikean sarakkeen esikatselussa.

Kirjoitat	Saat
# Otsikko, ## Osio, ### Alaosio	Tasojen 1, 2 ja 3 otsikot (tasoon 6 asti merkinnällä ######)
**lihavoitu** ja *kursiivi*	lihavoitu ja kursiivi
~~vanha~~	vanha
`koodi`	koodi tasalevyisellä fontilla
[teksti](https://example.com)	linkki
	kuva
- kohta tai 1. kohta	luettelomerkitty tai numeroitu luettelo
- [ ] tehtävä ja - [x] valmis	tarkistuslista valintaruutuineen
> lainattu teksti	lainaus
kolme takahipsua omalla rivillään ennen koodia ja sen jälkeen	koodilohko
--- omalla rivillään	vaakaviiva
teksti[^1] ja [^1]: huomautus	alaviite

Markdown-taulukko tarvitsee otsikkorivin, viivoista koostuvan erotinrivin ja sen jälkeen yhden rivin kutakin taulukon riviä kohden, ja solut erotetaan merkillä |. Erotinrivin kaksoispiste määrää tasauksen: :-- tasaa vasemmalle, :-: keskittää ja --: tasaa oikealle. Taulukko-painike lisää valmiin kolmen sarakkeen taulukon pohjaksi. Solujen ei tarvitse olla lähdetekstissä kohdakkain, mutta kohdistaminen helpottaa taulukon muokkaamista myöhemmin.

Markdown hyväksyy myös HTML:ää asioihin, joille sillä ei ole omaa syntaksia, kuten <kbd>Ctrl</kbd> näppäimille, <sub> ja <sup> merkinnöille H₂O ja x² tai <details> osiolle, joka avautuu napsauttamalla. Skriptit, tyylit ja lomakkeet poistetaan esikatselusta turvallisuussyistä.

Kopioi muotoiltuna tekstinä tai lataa tiedosto

Kopioi Markdown kopioi lähdetekstin, Kopioi HTML kopioi siistin HTML:n verkkosivulle tai CMS:ään ja Kopioi muotoiltuna tekstinä kopioi muotoillun tuloksen. Liitä se Google Docsiin, Wordiin, Outlookiin tai Gmailiin, niin otsikot, lihavoitu teksti, luettelot, linkit ja taulukot tulevat perille muotoiltuina ilman Markdown-merkkejä.

Lataa-painikkeet tallentavat asiakirjan yhdellä napsautuksella Markdown-, PDF-, Word-, HTML- tai tekstitiedostona, ja tiedosto nimetään front matterin otsikon tai asiakirjan ensimmäisen otsikon mukaan. Ne käyttävät järkeviä oletusasetuksia: A4-paperi (Letter Yhdysvalloissa, Kanadassa, Meksikossa ja muissa maissa, joissa se on vakiokoko), normaalit reunukset ja 11 pisteen teksti. Jos haluat valita sivukoon, fontit ja reunukset, lisätä sisällysluettelon tai muuntaa useita tiedostoja kerralla, käytä painiketta Lisää vientiasetuksia. Se avaa Markdown-muuntimen, johon tekstisi on jo valmiiksi täytetty.

Usein kysytyt kysymykset

Lähetetäänkö tekstini palvelimelle tai tallennetaanko se jonnekin?

Ei. Esikatselu, muunnos ja lataukset tapahtuvat kaikki selaimessasi, eikä tekstiä koskaan lähetetä palvelimelle. Oletuksena mitään ei myöskään tallenneta, joten teksti katoaa, kun suljet välilehden. Jos valitset Säilytä luonnos tässä selaimessa, teksti tallennetaan oman selaimesi tallennustilaan jokaisen muutoksen jälkeen ja palaa seuraavalla käyntikerralla. Poista valinta yhteiskäyttöisellä tietokoneella, jolloin myös tallennettu luonnos poistetaan.

Miten avaan .md-tiedoston ja katselen sitä verkossa?

Napsauta työkalurivin tiedostopainiketta tai pudota tiedosto editoriin ja vaihda sitten näkymään Esikatselu, niin voit lukea sen muotoiltuna asiakirjana. Enintään 20 MB:n tiedostot UTF-8- tai UTF-16-muodossa avautuvat suoraan. Tiedoston kuvat näkyvät, jos niillä on täydellinen verkko-osoite; tietokoneellasi tiedoston vieressä olevia kuvia verkkosivu ei voi ladata.

Mitä Markdown-muunnelmaa editori käyttää?

Se noudattaa CommonMark-määritystä (englanniksi), standardia, jota useimmat Markdown-työkalut tukevat, sekä GitHubin laajennuksia: taulukot, tarkistuslistat, yliviivaus, automaattiset linkit ja alaviitteet. GitHubiin, GitLabiin, Obsidianiin, Redditiin tai Discordiin kirjoitettu teksti näyttää täällä samalta, lukuun ottamatta näiden palvelujen omia lisäominaisuuksia, kuten käyttäjämainintoja tai Obsidianin wikilinkkejä.

Miten saan Markdownin Google Docsiin?

Napsauta Kopioi muotoiltuna tekstinä ja liitä asiakirjaan. Otsikot, luettelot, linkit ja taulukot säilyttävät muotoilunsa. Google Docsin uusimmat versiot osaavat myös itse lukea Markdownia Muokkaa-valikon kautta, kun Markdown on ensin otettu käyttöön Työkalut-valikon asetuksissa.

Tukeeko editori Mermaid-kaavioita tai LaTeX-matematiikkaa?

Ei vielä. Mermaid-lohko näytetään tavallisena koodilohkona, ja muodossa $...$ kirjoitetut kaavat jäävät pelkäksi tekstiksi. Kaikki muu GitHub Flavored Markdownista on tuettu.

Mikä on Markdown ja kuka sitä käyttää?

Markdown on tapa muotoilla pelkkää tekstiä muutamalla merkillä. John Gruber kehitti sen vuonna 2004 niin, että asiakirja pysyy luettavana jo ennen kuin se muunnetaan HTML:ksi (lisää englanninkielisessä Wikipediassa). Kehittäjät käyttävät sitä README-tiedostoihin ja dokumentaatioon, kirjoittajat muistiinpanoihin ja luonnoksiin, ja tekoälychatit vastaavat sillä, minkä vuoksi niiden vastaukset ovat täynnä tähtiä ja risuaitoja, kun ne liitetään muualle.

Lisää tekstityökaluja löydät kategoriasta Teksti: voit verrata asiakirjan kahta versiota ja nähdä, mikä muuttui, tai muuttaa otsikoiden kirjainkokoa yhdellä kertaa. Kehittäjät löytävät JSON formatterin ja muita työkaluja kategoriasta Kehittäjät.