innhold/content/docs/brukerveiledning/formatering/page.md

# Formatering med Markdown

Markdown er et enkelt format for å skrive tekst med formatering. Du skriver ren tekst med noen enkle symboler for å markere overskrifter, lenker, bilder osv.

## Overskrifter

Bruk `#` for overskrifter. Flere `#` gir mindre overskrifter:

```markdown
# Hovedoverskrift (H1)
## Underoverskrift (H2)
### Mindre overskrift (H3)
```

**Viktig**: Den første `# Overskrift` i dokumentet blir sidens tittel (hvis du ikke setter tittel i metadata.ini).

## Avsnitt

Skriv vanlig tekst for avsnitt. Separer avsnitt med en tom linje:

```markdown
Dette er et avsnitt.

Dette er et nytt avsnitt.
```

## Uthevet tekst

```markdown
**Fet tekst** eller __fet tekst__
*Kursiv tekst* eller _kursiv tekst_
***Fet og kursiv***
```

Resultat:
- **Fet tekst**
- *Kursiv tekst*
- ***Fet og kursiv***

## Lister

### Punktliste

```markdown
- Punkt 1
- Punkt 2
- Punkt 3
```

Eller bruk `*`:

```markdown
* Punkt 1
* Punkt 2
```

### Nummerert liste

```markdown
1. Første punkt
2. Andre punkt
3. Tredje punkt
```

### Nestet liste

```markdown
- Hovedpunkt
  - Underpunkt
  - Enda et underpunkt
- Nytt hovedpunkt
```

## Lenker

```markdown
[Lenketekst](https://eksempel.no)
```

Resultat: [Lenketekst](https://eksempel.no)

### Lenke til annen side på samme nettsted

```markdown
[Les mer](/om-oss/)
```

## Bilder

```markdown
![Bildetekst](bilde.jpg)
```

### Bildefil i samme mappe

```markdown
![Mitt foto](foto.jpg)
```

### Bildefil i undermappe

```markdown
![Mitt foto](bilder/foto.jpg)
```

### Forsidebilde

Gi bildet navnet `cover.jpg`, `cover.webp` eller `cover.png`. Det vises automatisk i listevisninger (f.eks. på bloggsiden).

## Sitater

Bruk `>` for sitater:

```markdown
> Dette er et sitat.
> Det kan gå over flere linjer.
```

Resultat:
> Dette er et sitat.
> Det kan gå over flere linjer.

## Kode

### Kode i teksten (inline)

```markdown
Bruk `kode` i teksten slik.
```

Resultat: Bruk `kode` i teksten slik.

### Kodeblokk

Bruk tre backticks (`` ` ``) før og etter:

````markdown
```
Dette er en kodeblokk
med flere linjer
```
````

Med syntaksutheving:

````markdown
```php
<?php
echo "Hei verden";
?>
```
````

## Horisontale linjer

```markdown
---
```

Eller:

```markdown
***
```

Resultat:

---

## Tabeller

```markdown
| Kolonne 1 | Kolonne 2 | Kolonne 3 |
|-----------|-----------|-----------|
| Rad 1, celle 1 | Rad 1, celle 2 | Rad 1, celle 3 |
| Rad 2, celle 1 | Rad 2, celle 2 | Rad 2, celle 3 |
```

Resultat:

| Kolonne 1 | Kolonne 2 | Kolonne 3 |
|-----------|-----------|-----------|
| Rad 1, celle 1 | Rad 1, celle 2 | Rad 1, celle 3 |
| Rad 2, celle 1 | Rad 2, celle 2 | Rad 2, celle 3 |

## HTML i Markdown

Du kan også bruke HTML direkte hvis du trenger mer kontroll:

```markdown
Dette er Markdown-tekst.

<div class="spesiell-boks">
Dette er HTML.
</div>

Tilbake til Markdown.
```

## Beste praksis

### Bruk beskrivende bildetekster
```markdown
<!-- Bra -->
![Solnedgang over fjellene](solnedgang.jpg)

<!-- Dårlig -->
![Bilde](img001.jpg)
```

### Bruk absolutte stier for interne lenker
```markdown
<!-- Bra for interne lenker -->
[Om oss](/om-oss/)

<!-- Også greit, men absolutt sti er sikrere -->
[Om oss](https://dinside.no/om-oss/)
```

### Hold det enkelt
Bruk Markdown-syntaks framfor HTML når det er mulig. HTML skal bare brukes når Markdown ikke strekker til.

## Eksempel på komplett side

```markdown
# Min fantastiske artikkel

Dette er en introduksjon til artikkelen min.

## Hovedinnhold

Her er **hovedinnholdet**. Det kan inneholde:

- Punktlister
- Lenker til [andre sider](/om-oss/)
- Bilder

![Eksempelbilde](bilde.jpg)

## Konklusjon

Dette var det! Enkelt og greit.
```