Avansert bruk av Markdown

Dette avsnittet utvider basisinformasjonen gitt i avsnittet "Formater tekst med Markdown" for å gi de med spesielle krav nødvendig informasjon for å få mest mulig ut av formatteringsspråket. Dersom du ikke ser, eller ikke trenger, formatteringen som vises under kan du godt hoppe over dette avsnittet og heller lese dette dersom behovet skulle oppstå.

(Enda mer) Avanserte muligheter er tilgjengelige. Se avsnittet for ekstra funksjoner .

Linjeskift

I noen tekster, f.eks. dikt og vers, er det ofte behov for ekstra linjeskift. Retur-tasten gir ikke ønsket resultat og alt vises som en sammenhengende tekststreng.

The best laid schemes o' Mice an' Men,
Gang aft agley,
An' lea'e us nought but grief an' pain,
For promis'd joy!

Teksten over vil gi dette resultatet dersom du bare bruker Retur-tasten på slutten av hver linje:

The best laid schemes o' Mice an' Men, Gang aft agley, An' lea'e us nought but grief an' pain, For promis'd joy!

Dersom du derimot avslutter hver linje med to mellomrom før du trykker Retur-tasten, vil det i stedet bli slik.

The best laid schemes o' Mice an' Men,
Gang aft agley,
An' lea'e us nought but grief an' pain,
For promis'd joy!

Horisontale streker

Horisontale streker kan lages ved på skrive tre eller flere asterisks (*), streker (-) eller understreker (_) på en egen linje.

Dette vil fungere:

***

men du kan legge til mellomrom og tegn for å gjøre det mer åpenbart at dette er en avsnittsskift.

* * * * *

-------------------------

_ _ _ _ _

Alle disse metodene gir samme resultat:


Lenkede bilder

Formater tekst med Markdown har instruksjoner for hvordan du lager lenker og legger til bilder. Det er kanskje ikke like åpenbart at dette kan kombineres og gjøre bilder klikkbare.

[the google search engine][google]

![the google logo][logo]

Over ser du en standard lenke og et bilde. Ved å plassere bildet der hvor lenketeksten skulle vært, får du dette resultatet:

[![the google logo][logo]][google]

Linjen over i kombinasjon med følgende lenke et annet sted i dokumentet:

[logo]: http://www.google.com/images/logo.gif
[google]: http://www.google.com/ "click to visit Google.com"

kombineres for å lage følgende klikkbare bilde (med pekertips dersom muspekeren føres over bildet):

the google logo

Et eksempel på hvor denne teknikken er fin er hvor du lenker småbilder til større utgaver for nedlasting.

Tabeller

Du kan også lage enkle HTML-tabeller med Markdown. Her er et eksempel:

Navn    |   Alder
--------|------
Fred    |   29
Jim     |   47
Harry   |   32
Navn Alder
Fred 29
Jim 47
Harry 32

Du kan legge inn vanlig formattering i cellene. Kolonner kan venstre/høyre-justeres ved å legge til et kolon før eller etter den horisontale streken.

Definisjonslister

Definisjonslister består av begreper fulgt av definisjoner. Omtrent som en ordbok. Et enkelt eksempel får du her:

Moodle
:   En velkjent læringsplattform for nettbasert læring

PHP
:   Et skriptspråk.
    Brukes mest til å lage interaktive webprogrammer.
Moodle
En velkjent læringsplattform for nettbasert læring
PHP
Et skriptspråk. Brukes mest til å lage interaktive webprogrammer.

Fotnoter

En fotnote har to elementer. Et merke i teksten som vises opphevet nummer og en fotnotedefinisjon som fremkommer på slutten av dokumentet. Her er et eksempel:

Les mer om dette i min bok.[^1]

[^1]: Alt om min bok.

Du kan plassere fotnotedefinisjoner hvor du vil. De vil bli vist i den rekkefølgen de forekommer i teksten. Du kan ikke lenke til samme fotnote mer enn en gang.

Embedet HTML

Dersom du allerede er fortrolig med HTML kan det være tilfeller hvor Markdown ikke lar deg få den kontrollen du er vant med. Heldigvis er Markdown konstruert for disse unntakene og lar deg legge til embedded HTML rett i Markdown formatert tekst.

* <small>liten tekst</small>
* <big>stor tekst</big>

Merk at HTML koder kan fungere sammen med Markdown for punktmerkede lister. Dette fritar deg fra å skrive kompleks HTML-kode for å vanlig formatering for setninger og lister, samtidig som du har alle muligheter til å formatere tekten som du ønsker. /p>

Vise HTML eller Preformatert tekst

Dersom du, til forskjell fra forrige avsnitt, ønsker å vise HTML akkurat som du skrev det inn (som eksempelkode f.eks.), kan du innlede hver linje med fire mellomrom.

<p>En setning i <b>HTML</b> vist som kode</p>

Dette virker på samme måte når du skriver maskinkode:

print "Command-line arguments: (@ARGV)\n";

Siden slik formatering ofte brukes i programkode og samtidig kan konflikte med Markdown, slår du av Markdown formatering for disse linjene:

Normalt skulle dette ordet vises som **uthevet**.

For å inkludere slike bokstaver i normal tekst, se avsnittet under.

Bruk av spesialtegn

Dersom du ønsker å bruke spesialtegn som kan trigge Markdown kan tegnene innledes med en bakoverstrek (backslash). Da vises påfølgende tegn akkurat som det er skrevet inn - uten formatering.

\*asterisks, not emphasis\*

blir

*asterisks, not emphasis*

i stedet for

*emphasis, not asterisks*

som gir

emphasis, not asterisks

Videre lesning

Markdownsystemet er ikke unikt for Moodle, det brukes i stadig flere webbaserte publiseringsverktøy. Du kan finne mer informasjon om Markdown her: http://daringfireball.net/projects/markdown/

Moodle bruker en versjon av Markdown med tilleggsfunksjoner kjent som "Markdown extra". Du kan lese mer om dette på http://www.michelf.com/projects/php-markdown/extra/ .