Inline links
For at oprette et inline-link skal du bruge et sæt almindelige parenteser umiddelbart efter linktekstens afsluttende firkantede parentes. Inden for parentesen skal du sætte URL'en, hvor du vil have linket til at pege sammen med en valgfri titel til linket, omgivet af anførselstegn. For eksempel:
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
Vil producere:
<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>
<p><a href="http://example.net/">This link</a> has no
title attribute.</p>
Hvis du henviser til en lokal ressource på den samme server, kan du bruge relative stier:
See my [About](/about/) page for details.
Angivelse af HTML-attributter i markdown
For at tilføje en eller flere attributter til et markdown-link kan du bruge følgende mellemrumsseparerede format:
[link text](url){: attribute="value" attribute2="value2" attribute3="value3"}
Eksterne links
Du kan advare læserne om, at et link vil føre til et eksternt websted ved at tilføje {: .external}
til syntaksen.
Reference links
Links i referencestil bruger et andet sæt firkantede parenteser, inden for hvilke du placerer en etiket efter eget valg for at identificere linket:
This is [an example][id] reference-style link.
Du kan valgfrit bruge et mellemrum til at adskille sættene af beslag:
This is [an example] [id] reference-style link.
Så, hvor som helst i dokumentet, definerer du din linketiket sådan her på en linje for sig selv:
Link-URL'en kan eventuelt være omgivet af vinkelparenteser:
Du kan sætte title-attributten på næste linje og bruge ekstra mellemrum eller tabulatorer til udfyldning, som har en tendens til at se bedre ud med længere URL'er:
Linkdefinitionsnavne kan bestå af bogstaver, tal, mellemrum og tegnsætning – men de skelner ikke mellem store og små bogstaver. Fx disse to links:
[link text][a]
[link text][A]
er ækvivalente.
Den implicitte genvej til linknavn giver dig mulighed for at udelade navnet på linket, i hvilket tilfælde selve linkteksten bruges som navn. Bare brug et sæt firkantede parenteser -- f.eks. for at linke ordet "Google" til google.com-webstedet, kan du blot skrive:
[Google]
Og definer derefter linket:
Fordi linknavne kan indeholde mellemrum, fungerer denne genvej endda for flere ord i linkteksten:
Visit [Daring Fireball] for more information.
Og definer derefter linket:
Linkdefinitioner kan placeres hvor som helst i dit Markdown-dokument. Jeg plejer at sætte dem umiddelbart efter hvert afsnit, hvor de bruges, men hvis du vil, kan du sætte dem alle i slutningen af dit dokument, ligesom fodnoter.
Her er et eksempel på referencelinks i aktion:
I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].
Ved at bruge genvejen til det implicitte linknavn kan du i stedet skrive:
I get 10 times more traffic from [Google] than from
[Yahoo] or [MSN].
Begge ovenstående eksempler vil producere følgende HTML-output:
<p>I get 10 times more traffic from <a href="http://google.com/"
title="Google">Google</a> than from
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a>
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p>
Til sammenligning er her det samme afsnit skrevet ved hjælp af Markdowns inline-linkstil:
I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").
Automatiske links
Markdown understøtter en genvejsstil til oprettelse af "automatiske" links til URL'er og e-mail-adresser: omgiv blot URL'en eller e-mailadressen med vinkelparenteser. Hvad dette betyder er, at hvis du vil vise den faktiske tekst af en URL eller e-mail-adresse, og også have det et klikbart link, kan du gøre dette:
<http://example.com/>
Markdown vil gøre dette til:
<a href="http://example.com/">http://example.com/</a>
Automatiske links til e-mail-adresser fungerer på samme måde, bortset fra at Markdown også udfører en smule randomiseret decimal- og hex-entity-kodning for at hjælpe med at skjule din adresse fra spambots, der indsamler adresser. For eksempel vil Markdown ændre dette:
<address@example.com>
til noget som dette:
<a href="mailto:addre
ss@example.co
m">address@exa
mple.com</a>
som gengives i en browser som et klikbart link til "address@example.com".