Markdown-syntaksiohje
Olennaista syntaksia dokumenttien muotoiluun
Yleiskatsaus
Markdown on kevyt merkintäkieli, jolla voit lisätä muotoiluelementtejä pelkkään tekstiin. John Gruberin luoma 2004 Markdown on nyt yksi maailman suosituimmista merkintäkielistä.
Markdownin käyttö eroaa WYSIWYG-editorista. Esimerkiksi Microsoft Wordissa napsautat painikkeita sanojen ja lauseiden muotoiluun, ja muutokset näkyvät heti. Markdown ei toimi niin. Kun luot Markdown-muotoillun tiedoston, lisäät Markdown-syntaksia tekstiin osoittaaksesi, mitkä sanat ja lauseet näyttävät erilaisilta.
Otsikot
Luo otsikko lisäämällä risuaita (#) sanan tai lauseen eteen. Risuaiden määrä vastaa otsikon tasoa. Esim. kolmannen tason otsikko: ### Otsikkoni.
Heading level 1
Heading level 2
Heading level 3
Heading level 4
Heading level 5
Heading level 6
Kappaleet
Luo kappaleita käyttämällä tyhjää riviä yhden tai useamman tekstirivin erottamiseen.
It lets me write easily.
<p>It lets me write easily.</p>
I really like using Markdown.
It lets me write easily.
Rivinvaihdot
Luo rivinvaihto tai uusi rivi lopettamalla rivi kahdella tai useammalla välilyönnillä ja painamalla sitten enter.
And this is the second line.
And this is the second line.</p>
This is the first line.
And this is the second line.
Korostus
Voit korostaa tekstiä lihavoimalla tai kursivoimalla.
Lihavoi
Lihavoidaksesi tekstin, lisää kaksi asteriskia (**) tai alaviivaa (__) sanan tai lauseen eteen ja perään.
I just love bold text.
I just love bold text.
Kursivoi
Kursivoidaksesi tekstin, lisää yksi asteriski (*) tai alaviiva (_) sanan tai lauseen eteen ja perään.
The cat meows.
The cat meows.
Lihavoi ja kursivoi
Korosta tekstiä sekä lihavoituna että kursiivina lisäämällä kolme asteriskia (***) tai alaviivaa (___) sanan tai lauseen eteen ja perään.
This text is really important.
This text is really important.
Lainauslohkot
Luo lainauslohko lisäämällä > kappaleen eteen.
Dorothy followed her through many of the beautiful rooms in her castle.
Sisäkkäiset lainauslohkot
Lainauslohkot voi sisäkkäistää. Lisää >> sen kappaleen eteen, jonka haluat sisäkkäiseksi.
>
>> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
Dorothy followed her through many of the beautiful rooms in her castle.
The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
Luettelot
Voit järjestää kohdat järjestetyiksi ja järjestämättömiksi luetteloiksi.
Järjestetyt luettelot
Järjestettyyn luetteloon lisää rivejä numeroilla ja pisteen. Numeroiden ei tarvitse olla numeerisessa järjestyksessä, mutta luettelon tulee alkaa ykkösellä.
2. Second item
3. Third item
4. Fourth item
<li>First item</li>
<li>Second item</li>
<li>Third item</li>
<li>Fourth item</li>
</ol>
- First item
- Second item
- Third item
- Fourth item
Järjestämättömät luettelot
Järjestämättömään luetteloon lisää viivoja (-), asteriskeja (*) tai plusmerkkejä (+) rivien eteen.
- Second item
- Third item
- Fourth item
<li>First item</li>
<li>Second item</li>
<li>Third item</li>
<li>Fourth item</li>
</ul>
- First item
- Second item
- Third item
- Fourth item
Koodi
Merkitse sana tai lause koodiksi laittamalla se takaslasheen (`) väliin.
At the command prompt, type nano.
Koodilohkot
Luo koodilohko sisentämällä jokainen rivi vähintään neljällä välilyönnillä tai yhdellä sarkaimella, tai käytä kolmea takaslashea (```) koodilohkon eteen ja perään.
{
"firstName": "John",
"lastName": "Smith",
"age": 25
}
```
{
"firstName": "John",
"lastName": "Smith",
"age": 25
}Vaakaviivat
Luo vaakaviiva käyttämällä kolmea tai useampaa asteriskia (***), viivaa (---) tai alaviivaa (___) omalla rivillään.
Linkit
Luo linkki laittamalla linkkiteksti hakasulkeisiin (esim. [Duck Duck Go]) ja heti perään URL sulkeissa (esim. (https://duckduckgo.com)).
My favorite search engine is Duck Duck Go.
Otsikoiden lisääminen
Voit halutessasi lisätä linkille otsikon. Se näkyy työkaluvihjeenä, kun käyttäjä vie kursorin linkin päälle. Lisää otsikko lainausmerkeissä URL:n perään.
My favorite search engine is Duck Duck Go.
Kuvat
Lisää kuva lisäämällä huutomerkki (!), sen jälkeen vaihtoehtoinen teksti hakasulkeissa ja kuvan polku tai URL sulkeissa. Voit halutessasi lisätä otsikon lainausmerkeissä polun tai URL:n perään.
Escape-merkit
Näyttääksesi kirjaimellisen merkin, jota muuten käytetään Markdown-dokumentin muotoiluun, lisää kenoviiva (\) merkin eteen.
* Without the backslash, this would be a bullet in an unordered list.
Merkit, joita voit escapettaa
Voit käyttää kenoviivaa seuraavien merkkien escapettamiseen:
| \ | backslash |
| ` | backtick |
| * | asterisk |
| _ | underscore |
| { } | curly braces |
| [ ] | brackets |
| ( ) | parentheses |
| # | pound sign |
| + | plus sign |
| - | minus sign (hyphen) |
| . | dot |
| ! | exclamation mark |
| | | pipe |
Taulukot
Luo taulukko käyttämällä kolmea tai useampaa viivaa (---) kunkin sarakkeen otsikkoon ja pystyviivoja (|) sarakkeiden erottamiseen. Voit halutessasi lisätä pystyviivat taulukon molempiin päihin.
| --------- | ----------- |
| Header | Title |
| Paragraph | Text |
| Syntax | Description |
|---|---|
| Header | Title |
| Paragraph | Text |
Tasaus
Voit tasata tekstin sarakkeissa vasemmalle, oikealle tai keskelle lisäämällä kaksoispisteen (:) viivojen vasemmalle, oikealle tai molemmille puolille otsikkorivillä.
| :--- | :---: | ---: |
| This | This | This |
| column | column | column |
| will | will | will |
| align | align | align |
| left | center | right |
| Tasaa vasemmalle | Keskitä | Tasaa oikealle |
|---|---|---|
| This | This | This |
| column | column | column |
| will | will | will |
| align | align | align |
| left | center | right |