Mika on Markdown?

Markdown on kevyt merkintakieli, jonka John Gruber loi vuonna 2004, ja joka mahdollistaa muotoillun tekstin kirjoittamisen pelkalla tekstilla. Se on laajalti kaytetyy README-tiedostoissa, dokumentaatiossa, blogikirjoituksissa, Discordissa, Redditissa ja tuhansissa muissa sovelluksissa.

Tama tyokalu tarjoaa reaaliaikaisen esikatselun Markdownistasi kirjoittaessasi. Vasen paneeli nayttaa raakaa Markdown-lahdekoodia ja oikea paneeli nayttaa renderoidun tulosteen. Tama mahdollistaa muotoilun naakemisen valittomasti kirjoittaessasi.

Markdown-perussyntaksi

• Otsikot: kayta # H1:lle, ## H2:lle, ### H3:lle ja niin edelleen ###### H6:een asti.
• Lihavointi: kayata teksti kaksinkertaisiin tahtiin tai alaviivoin. Kursiivi: kayta yksinkertaisia tahtia tai alaviivoja.
• Listat: aloita rivit - tai * -merkilla luettelomerkeille tai 1. numeroiduille listoille. Sisenna alislistoja.
• Linkit: [linkkiteksti](URL). Kuvat: .
• Koodi: kayta heittomerkkeja rivinsisaiselle koodille, kolminkertaisia heittomerkkeja koodilohkoille valinnaisen kielimaarittelyn kera syntaksikorostusta varten.

Tyokalun kayttohje

Kirjoita tai liita Markdown-tekstia editoriin. Esikatselu paivittyy reaaliajassa. Voit vaihtaa rinnakkais- ja esikatselutilojen valilla. Kopioi renderoitu HTML tai vie Markdown-lahde.

GitHub Flavored Markdown

GitHub Flavored Markdown laajentaa standardi-Markdownia taulukoilla (putki-erotetuilla sarakkeilla), tehtavalistoilla (valintaruuduilla - [ ] ja - [x]), automaattisilla URL-linkeilla, yliviivaustekstilla (~~teksti~~) ja koodilohkojen syntaksikorostuksella. Se on de facto standardi kehittajaymparistoissa.

Käytännön esimerkki

Kirjoita ## Setup omalle rivilleen, niin esikatselu näyttää tason 2 otsikon. Ympäröi ilmaus kaksinkertaisilla tähdillä — **tallenna usein** — lihavointia varten, ja aloita rivit yhdysviivalla ja välilyönnillä luodaksesi luettelon. Kolmella takakenolla ja sanalla js avattu koodilohko tuottaa korostetun koodin. Koska Markdown on pelkkää tekstiä, sama tiedosto pysyy luettavana missä tahansa editorissa ja muuntuu siististi HTML:ksi verkkoa varten.

Yleisiä virheitä

Yleisin moka on unohtaa tyhjä rivi kappaleen ja luettelon tai otsikon välistä — ilman sitä monet jäsentimet yhdistävät ne yhdeksi lohkoksi. Sisäkkäiset luettelot vaativat yhtenäisen kahden tai neljän välilyönnin sisennyksen, ei sarkaimia sekaisin välilyöntien kanssa. Ja vaikka useimmissa Markdown-versioissa raaka HTML on sallittua, kirjaimellisiksi tarkoitetut kulmasulkeet, kuten div-tunniste, on suojattava tai ympäröitävä takakenoilla, tai ne katoavat tuloksesta.

Usein kysytyt kysymykset

Voinko kayttaa HTML:aa Markdownin sisalla?

Kylla. Standardi Markdown sallii rivinsisaisen HTML:n kaikkeen, mita Markdown-syntaksi ei voi ilmaista (kuten monimutkaiset taulukot, variilliset elementit tai interaktiiviset komponentit). Suurin osa Markdown-jasentimista renderoi HTML-tagit suoraan. Jotkut alustat (kuten GitHub-kommentit) suodattavat tiettyjae tageja tietoturvasyista.

Mika on Markdownin ja rikkaan tekstin ero?

Rikas teksti (kuten Word-asiakirjat) tallentaa muotoilun piilotettuina koodeina tiedoston sisalla. Markdown tallentaa muotoilun nakyvina merkkeinae, jotka voi lukea ja muokata milla tahansa tekstieditorilla. Markdown on versiohallintaystavallinen, kevaempi ja alustariippumaton.

Onko Markdown kaikkialla sama?

Ydinsyntaksi on standardoitu CommonMarkilla, mutta variantit eroavat. GitHub Flavored Markdown lisää taulukot, tehtävälistat ja yliviivauksen; muut alustat tukevat alaviitteitä tai matematiikkaa. Kun siirrettävyys on tärkeää, pitäydy CommonMarkin perusteissa ja testaa kohdejärjestelmässä.