243 lines
3.5 KiB
Markdown
243 lines
3.5 KiB
Markdown
# 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](../annen-side/)
|
|
```
|
|
|
|
## Bilder
|
|
|
|
```markdown
|
|
|
|
```
|
|
|
|
### Bildefil i samme mappe
|
|
|
|
```markdown
|
|
|
|
```
|
|
|
|
### Bildefil i undermappe
|
|
|
|
```markdown
|
|
|
|
```
|
|
|
|
### 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 -->
|
|
|
|
|
|
<!-- Dårlig -->
|
|
|
|
```
|
|
|
|
### Bruk relative lenker
|
|
```markdown
|
|
<!-- Bra for interne lenker -->
|
|
[Om oss](../om-oss/)
|
|
|
|
<!-- Mindre bra -->
|
|
[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](../annen-side/)
|
|
- Bilder
|
|
|
|
|
|
|
|
## Konklusjon
|
|
|
|
Dette var det! Enkelt og greit.
|
|
```
|