Share this page

Learn X in Y minutes

Where X=markdown

John Gruber loi Markdownin vuona 2004. Sen tarkoitus on olla helposti luettava ja kirjoitettava syntaksi joka muuntuu helposti HTML:ksi (ja nyt myös moneksi muuksi formaatiksi).

<!-- Jokainen HTML-tiedosto on pätevää Markdownia. Tämä tarkoittaa että voimme
käyttää HTML-elementtejä Markdownissa, kuten kommentteja, ilman että markdown
-jäsennin vaikuttaa niihin. Tästä johtuen et voi kuitenkaan käyttää markdownia
HTML-elementtien sisällä jos luot sellaisen markdown-tiedostoon. -->

<!-- Markdownin toteutus vaihtelee jäsentimestä toiseen. Tämä opas yrittää
selventää mitkä ominaisuudet ovat yleisiä ja mitkä ovat eritysesti tiettyjen
jäsentimien ominaisuuksia. -->

<!-- Otsikot -->
<!-- Voit luoda HTML-elementtejä <h1> - <h6> helposti aloittamalla rivin
haluamallasi määrällä ristikkomerkkejä (#).  -->
# Tämä on <h1>
## Tämä on <h2>
### Tämä on <h3>
#### Tämä on <h4>
##### Tämä on <h5>
###### Tämä on <h6>

<!-- Markdownissa on myös vaihtoehtoisia tapoja ilmaista h1 ja h2. -->
Tämä on h1
=============

Tämä on h2
-------------

<!-- Yksinkertaiset tekstimuotoilut -->
<!-- Tekstin voi helposti muotoilla kursiiviksi tai lihavoiduksi. -->

*Tämä teksti on kursivoitua.*
_Kuten on myös tämä teksti._

**Tämä teksti on lihavoitua.**
__Kuten on tämäkin teksti.__

***Tämä teksti on molempia.***
**_Kuten tämäkin!_**
*__Kuten tämäkin!__*

<!-- GitHub-tyylisessä Markdownissa, jota käytetään tiedostojen esittämiseksi
GitHubissa, meillä on käytössämme myös yliviivaus: -->

~~Tämä teksti on yliviivattua.~~

<!-- Kappaleet ovat yhdellä tai useammalla peräkkäisellä tekstirivillä jotka
erotellaan yhdellä tai useammalla tyhjällä rivillä -->

Tämä on kappala. Kirjoittelen kappaleeseen, eikö tämä olekin hauskaa?

Nyt olen kappaleessa 2.
Olen edelleen toisessa kappaleessa!


Olen kolmannessa kappaleessa!

<!-- Jos haluat lisätä <br /> HTML-elementin, päätä kappale kahdella tai
useammalla välilyönnillä ja aloita sitten uusi kappale -->

Päätän tämän kahteen välilyöntiin (maalaa minut nähdäksesi ne).  

There's a <br /> above me!

<!-- Lainaukset ovat helppoja ja ne tehdään >-merkillä -->

> Tämä on lainaus. Voit joko
> manuaalisesti rivittää tekstisi ja laittaa >-merkin jokaisen rivin eteen tai antaa jäsentimen rivittää pitkät tekstirivit.
> Sillä ei ole merkitystä kunhan rivit alkavat >-merkillä.

> Voit myös käyttää useampaa
>> sisennystasoa
> Kuinka hienoa se on?

<!-- Listat -->
<!-- Järjestämättömät listat tehdään asteriskilla, plussalla tai viivalla -->

* Kohta
* Kohta
* Kolmas kohta

tai

+ Kohta
+ Kohta
+ Kolmas kohta

tai

- Kohta
- Kohta
- Kolmas kohta

<!-- Järjestetyt listat tehdään järjestysluvuilla. -->

1. Kohta yksi
2. Kohta kaksi
3. Kohta kolme

<!-- Sinun ei tarvitse edes merkitä kohtia oikein ja silti markdown näyttää
oikean järjestyksen, mutta se ei välttämättä ole hyvä idea. -->

1. Kohta yksi
1. Kohta kaksi
1. Kohta kolme
<!-- (Tämä korjaantuu samanlaiseksi kuin yllä oleva esimerkki) -->

<!-- Voit myös käyttää alalistoja. -->

1. Kohta yksi
2. Kohta kaksi
3. Kohta kolme
    * Alakohta
    * Alakohta
4. Kohta neljä

<!-- Myös tehtävälistoja on olemassa. Tämä tekee HTML-valintaruutuja. -->

Alla olevat ruudut ilman x-merkkiä ovat merkitsemättömiä HTML-valintaruutuja.
- [ ] Ensimmäinen suoritettava tehtävä.
- [ ] Toinen tehtävä joka täytyy tehdä
Tämä alla oleva ruutu on merkitty HTML-valintaruutu.
- [x] Tämä tehtävä on suoritettu

<!-- Koodiosiot -->
<!-- Voit merkitä koodiosion (jaka käyttää <code> -elementtiä) sisentämällä
rivin neljällä välilyönnillä tai tabulaattorilla. -->

    Tämä on koodia
    Kuten tämäkin

<!-- Voit myös sisentää koodia samalla tavalla. -->

    my_array.each do |item|
        puts item
    end

<!-- Muun tekstin seassa oleva koodi merkitään kahden `-merkin väliin -->

John ei tiennyt edes mitä `go_to()` -funktio teki!

<!-- GitHubin Markdownissa voit käyttää erityissyntaksia koodille. -->

\`\`\`ruby <!-- paitsi että poista nuo kenoviivat, vain ```ruby ! -->
def foobar
    puts "Hello world!"
end
\`\`\` <!-- tästä myös, ei kenoviivoja, vain ``` -->

<!-- Yllä oleva teksti ei vaadi sisennystä. Lisäksi GitHub käyttää ``` jälkeen
mainitsemasi kielen syntaksin korostusta  -->

<!-- Vaakaviiva (<hr />) -->
<!-- Vaakaviivojen lisääminen käy näppärästi kolmella tai useammalla
asteriskilla taikka viivalla, välilyönneillä tai ilman -->

***
---
- - -
****************

<!-- Linkit -->
<!-- yksi markdownin parhaita ominaisuuksia on yksinkertaiset hyperlinkit. Laita
näytettävä teksti hakasulkuihin [] ja URL-osoite perään sulkeissa (). -->

[Klikkaa tästä!](http://example.com/)

<!-- Voit myös lisätä linkin otsikon heittomerkeissä osoitteen perään. -->

[Klikkaa tästä!](http://example.com/ "Linkki Example.com:iin")

<!-- Suhteelliset polut toimivat myös. -->

[Musiikkia](/musiikki/).

<!-- Markdown tukee myös viittaustyylisiä linkkejä. -->

[Klikkaa tätä linkkiä][link1] saadaksesi lisätietoja!
[Katso myös tämä linkki][foobar] jos haluat.

[link1]: http://example.com/ "Siistii!"
[foobar]: http://foobar.biz/ "Selkis!"

<!-- Otsikko voi olla myös ykittäisissä heittomerkeissä tai sulkeissa, tai
ohitettu kokonaan. Viittaukset voivat olla missä tahansa kohdassa dokumenttia ja
viittausten ID:t voivat olla mitä tahansa kunhan ne ovat uniikkeja. -->

<!-- Voit myös käyttää linkin tekstiä ID:nä näin: -->

[This][] is a link.

[this]: http://tämäonlinkki.com/

<!-- Mutta tämä tapa ei ole yleinen. -->

<!-- Kuvat -->
<!-- Kuvat tehdään samalla tavalla kuin linkitkin, mutta huutomerkki edessä! -->

![Kuvan alt-attribuutti](http://imgur.com/munkuva.jpg "Vaihtoehtoinen otsikko")

<!-- Ja viittaukset toimivat odotetusti. -->

![Tämä on se alt-attribuutti][munkuva]

[munkuva]: suhteellinen/polku/siitii/kuva.jpg "otsikko tähän tarvittaessa"

<!-- Sekalaista -->
<!-- Automaattiset linkit -->

<http://testwebsite.com/> on sama kuin
[http://testwebsite.com/](http://testwebsite.com/)

<!-- Automaattiset sähköpostilinkit -->

<[email protected]>

<!-- Varattujen merkkien käyttö -->

haluan kirjoittaa *tämän tekstin jonka ympärillä on asteriskit* mutta en halua
sen kursivoituvan, joten teen näin: \*tämän tekstin ympärillä on asteriskit\*.

<!-- Näppäimistön näppäimet -->
<!-- GitHubin Markdownissa, voit käyttää <kbd> -tagia esittämään näppäimiä -->

Tietokoneesi kaatui? Kokeile painaa
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>

<!-- Taulukot -->
<!-- Taulukot ovat saatavilla vain GitHubin markdownissa ja ne ovat melko
vaivalloisia käyttää, mutta jos todella haluat: -->

| Kolumni1     | Kolumni2 | Kolumni3      |
| :----------- | :------: | ------------: |
| Vasemmalle   | Keskelle | Oikealle      |
| blaa         | blaa     | blaa          |

<!-- vaihtoehtoisesti, sama tulos -->

Kolumni 1 | Kolumni 2 | Kolumni 3
:-- | :-: | --:
Hyi tämä on ruma | saa se | loppumaan

<!-- Loppu! -->

Lisää tietoa löydät John Gruberin virallisesta julkaisusta ja Adam Pritchardin loistavasta lunttilapusta.


Got a suggestion? A correction, perhaps? Open an Issue on the GitHub Repo, or make a pull request yourself!

Originally contributed by Dan Turkel, and updated by 2 contributors.