3.6 KiB
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:
# 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:
Dette er et avsnitt.
Dette er et nytt avsnitt.
Uthevet tekst
**Fet tekst** eller __fet tekst__
*Kursiv tekst* eller _kursiv tekst_
***Fet og kursiv***
Resultat:
- Fet tekst
- Kursiv tekst
- Fet og kursiv
Lister
Punktliste
- Punkt 1
- Punkt 2
- Punkt 3
Eller bruk *:
* Punkt 1
* Punkt 2
Nummerert liste
1. Første punkt
2. Andre punkt
3. Tredje punkt
Nestet liste
- Hovedpunkt
- Underpunkt
- Enda et underpunkt
- Nytt hovedpunkt
Lenker
[Lenketekst](https://eksempel.no)
Resultat: Lenketekst
Lenke til annen side på samme nettsted
[Les mer](/om-oss/)
Bilder
Bildefil i samme mappe
Bildefil i undermappe
Forsidebilde
Gi bildet navnet cover.jpg, cover.webp eller cover.png. Det vises automatisk i listevisninger (f.eks. på bloggsiden).
Sitater
Bruk > for sitater:
> 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)
Bruk `kode` i teksten slik.
Resultat: Bruk kode i teksten slik.
Kodeblokk
Bruk tre backticks (`) før og etter:
```
Dette er en kodeblokk
med flere linjer
```
Med syntaksutheving:
```php
<?php
echo "Hei verden";
?>
```
Horisontale linjer
---
Eller:
***
Resultat:
Tabeller
| 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:
Dette er Markdown-tekst.
<div class="spesiell-boks">
Dette er HTML.
</div>
Tilbake til Markdown.
Beste praksis
Bruk beskrivende bildetekster
<!-- Bra -->
<!-- Dårlig -->
Bruk absolutte stier for interne lenker
<!-- 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
# 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
## Konklusjon
Dette var det! Enkelt og greit.