Markdown perusteet

Tämä ohje selittää täysin selkokielellä, miten Hugo-sivujen sisältöä kirjoitetaan ja miten saat perusmuotoilut käyttöön.
Kaikki muotoilu tehdään Markdownilla front matterin jälkeen.

1. Merkinnän alku = front matter (TOML)

Jokaisen sivun tai päiväkirjamerkinnän alussa on metadata:

+++
title = '2026-01-06: Otsikko'
date = 2026-01-06T18:00:00Z
draft = false
summary = "Lyhyt esittely"
+++

title = sivun nimi
date = julkaisuaika
draft = onko piilossa
summary = mitä listassa näytetään

Varsinainen teksti alkaa AINA tämän jälkeen.

2. Väliotsikot

# Pääotsikko
## Väliotsikko
### Pieni otsikko

Käytä päiväkirjassa mieluiten ## ja ###.

3. Tekstin korostus

**lihavoitu teksti**
*kursivoitu teksti*
~~yliviivattu~~
`koodimainen teksti`

4. Kappaleet

Tyhjä rivi erottaa kappaleet.

Tämä on ensimmäinen kappale.

Tämä on toinen kappale.

5. Listat

Ranskalainen lista

- Kohta yksi
- Kohta kaksi
  - Alakohta

Numeroitu lista

1. Aamu
2. Päivä
3. Ilta

6. Linkit

[Tämä on linkki](https://example.com)

7. Kuvat

Laita kuvat static/img/-kansioon.

![Kuvan selite](/img/kuva.png)

8. SVG-kaaviot tekstin sekaan

Jos haluat inline-SVG:n:

Tiedosto: assets/svg/kaavio.svg
Shortcode merkinnässä:

SVG not found: svg/kaavio.svg

CSS-vinkki:

.svg-inline svg {
  max-width: 100%;
  height: auto;
}

9. Taulukot

| Asia | Arvo |
|-----|-----|
| Lämpö | 43 C |
| Fiilis | hyvä |

10. Lainaukset

> Tärkeä ajatus

11. Koodi tekstin seassa

Koodiblokit kirjoitetaan näin:

print("Hei Hugo")

12. Erotusviiva

---

Hyvä osioiden väliin.

13. Tagit ja kategoriat

Lisää front matteriin:

tags = ["työ","server","PID"]
categories = ["diary"]

14. Hugo-workflow

Kun olet kirjoittanut:

hugo
rsync -a --delete public/ /var/www/diary/

15. Yleisimmät virheet

kirjoitus +++-osion sisään
draft = true
väärä kansio
unohtui hugo

16. Miksi Markdown?

Markdown on:

kevyt
nopea
toimii ilman nettiä
sama teksti on myös varmuuskopio.

Onnea kirjoittamiseen!