Hvordan redigere med Markdown-kommandoer

(Edit this document) (Create subordinate document)

Markdown betyr at dokumentteksten blir utvidet med “kommandoer” som angir typografiske detaljer, på en måte som gjør teksten mest mulig “leselig” mens den redigeres. De som har skrevet tekst med HTML-kommandoer har erfart at HTML kan “skygge for” teksten som gjør den tunglest mens man redigerer.

Grunnregelen er at du skriver teksten rett frem, med en blank linje der du ønsker et nytt avsnitt. De ferdighetene som er nødvendig for å utforme et vanlig dokument er tilegnet på mindre enn en halvtime.

Dette dokumentet viser eksempler på Markdown-redigering, og det er nødvendig å bruke (Edit this document) for å se sammenhengen mellom Markdown-kommandoer og det presenterte innholdet, evt. se Markdown-teksten i dette underordnede dokumentet.

Først overskrifter:

Overskrifter angir med én, to eller tre skigard-tegn (#) i første kolonne, slik:

Stor overskrift på øverste nivå

Underordnet overskrift

Avsnittoverskrift

Man kan også bruke dobbel (med likhetstegn) eller enkel understreking for dette formålet, slik:

Stor overskrift på øverste nivå

Underordnet overskrift

Utheving av tekst

Utheving av tekst skjer ved å sette ordet/ordene mellom stjerner (*) eller understreking (_). En stjerne/understreking på hver side gir kursivert tekst, mens to gir fet skrift. Tre gir fet kursiv.

“Skrivemaskin”

Med et gravistegn ("bakoverapostrof") på hver side av teksten vil den vises med en monospaced skriftsnitt, f.eks. Courier, som man husker fra gamle skrivemaskiner. Med slik formatering får man ikke uhevet teksten

Med *tre* gravistegn fås et 
avsnitt med samme skriftsnitt,
men hvor linjeskift blir fulgt.

Med fire innrykk fås et innrykket avsnitt med slikt skriftsnitt. Dette er en velegnet konstruksjon om man ønsker å gjengi programkode. Innrykket blir fire tegn kortere enn hva som blir skrevet inn.

    public class Test {
        public static void main(String[] args) {
            System.out.println("Hello World!");
       }
    }

Superscript og subscript

Der det behov for dette kan tegn som skal løftes eller senkes settes mellom par av ^-tegn (superscript) eller ~-tegn (subscript).

Eksempel: H~2~O er en væske. 2^10^=1024: H₂O er en væske. 2¹⁰=1024

Sitater og innrykk av avsnitt

Sitater skrives med et “større enn”-tegn i første kolonne. Slik tekst gis et innrykk. Husk å gi nytt “større enn”-tegn om du ønsker flere påfølgende avsnitt rykket inn.

Lister, punktlister og nummerlister

Punktlister fås ved å skrive en stjerne+blanktegn i begynnelsen av linjen. Det må være en blank linje over det første og etter det siste elementet i listen.

Punktliste med bindestrek
Nytt punkt
med bindestrek

Setter man en blank linje mellom det første og det andre elementet i listen, så blir hele listen vist frem dobbelt linjeavstand. Det er også mulig å skape nøstede lister ved hjelp av innrykk med fire blanktegn.

Ytre punktliste
Element 2
- Underliste
  - Underunderliste
- Underliste element 2
Ytre liste element 3

Nummererte lister lages på lignende måte, men med tall. Man trenger ikke skrive en nummerrekkefølge, 1-ere i hvert punkt virker også.

Ytre nummerliste
Ytre liste element 2
- Indre liste element 1
- Indre liste element 2
Ytre liste element 3

Tabeller

CMS søtter fremstilling av tabeller på flere måter. Her skal de forklares enkeltvis:

Enkle tabeller

Enkle tabeller skrives inn med en linje for kolonneoverskrifter, så en linje med bindestrekstegn som viser bredden av kolonnene. Deretter skrives tabellinjene inn med kolonnene orientert etter dette. Tabellcellene kan orienteres til høyre, venstre eller sentrert, bestemt av overskriftenes plassering i forhold til skillelinjen.

Enkel tabellutforming
Right	Left	Center	Default
12	12	12	12
123	123	123	123
1	1	1	1

Tabeller med celler som går over flere linjer

Flerlinje tabellceller
Sentrert overskrift	Standard orientering	Høyrejustert	Ventrejustert
Første	rad	12.77	Dyreste billetter som bare rikingene kan koste på seg.
Andre	balkong	6.50	Rimelige billetter. Kan kjøpes av dem som har andre ting å bruke penger på.

Kildeteksten til dette dokumentet viser hvordan en slik tabell utformes med en blank linje øverst og nederst, deretter en linje med bindestrekstegn, så kolonneoverksrifter og en ny linje som beskriver kolonnebredde. Tabellen vil bli vist så bred som mulig, og linjeskift i cellene kommer ikke nødvendigvis der de er skrevet inn.

Tabeller med innrammingstegn.

Se kildeteksten for å se utformingen av en slik tabell

Tabell utformet med innrammingstegn
Frukt	Pris	Ernæring
Bananer	12.50	Kalsium Sukker
Appelsiner	24.75	Vitamin C Sukker Fiber

En grunnleggende enkel tabell kan settes opp raskt, slik som i dette eksemplet:

Enkel tabell satt opp som såkalt “pipe table”
Frukt	Pris
Epler	23.60
Bananer	9.60
Appelsiner	23.10

Tabellutformingen er ikke veldig fleksibel. Layout er strengt kvadratisk uten rad- eller kolonnespenn og fremvisningen vil alltid gi rader med to alternerende farger. Ved ønske om mer fleksibel tabellutforming kan HTML-koder brukes.

Lenker til websider og dokumenter

Lenker til andre websider skrives inn slik:

[Hent Verdens gang](http://www.vg.no) Test:Hent Verdens gang

Lenker til websider på samme webtjener skrives inn slik

[Hent bilde fra webkameraet](/webcam.php) Test:Hent bilde fra webkameraet

Lenker til andre dokumenter på CMS krever at du dokument-id er kjent. Det står alltid oppført nederst på skjermen.

[Hent CMS hovedside](?docid=1) Test:Hent CMS hovedside

Inkludering av bilder

Markdown-kommandoen for å inkludere bilder lar oss ikke endre størrelsen på bildet, noe som svært ofte er nødvendig når store fotografier skal inkluderes på en webside. Det anbefales derfor å bruke en HTML-kommando i stedet (<img src=...>)

Bilder som skal inkluderes i et dokument må ligge på webtjenerens filsystem. For å laste opp bilder velges knappen [Picture Upload] på høyre sidepanel. bildene blir lagret i underkatalogen Pictures.

Bildene er tilgjengelig for alle dokumenter, så unngå navnekonflikter ved opplasting. De kan deretter refereres fra webtjeneren med URLen /Pictures/....

Kildeteksten viser eksempler på utforming av HTML-koden. Dersom man har en tegning el.lign som man ønsker inkludert i et dokument, kan denne metoden benyttes;

Forside Bilde av Nomi

Last update (UTC): 2024-01-03 19:45:47 by 192.168.2.160 - Docid: 10 - Parent docid: 1 Download docx