Saites

Lai izveidotu iekļautu saiti, izmantojiet parasto iekavu kopu tūlīt aiz saites teksta beigu kvadrātiekavas. Iekavās ievietojiet vietrādi URL, kur vēlaties norādīt saiti, kā arī neobligātu saites nosaukumu, kas ir ieskauts pēdiņās. Piemēram:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

Ražos:

<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>

Ja atsaucaties uz vietējo resursu tajā pašā serverī, varat izmantot relatīvos ceļus:

See my [About](/about/) page for details.

HTML atribūtu norādīšana iezīmēšanā

Lai atzīmes saitei pievienotu vienu vai vairākus atribūtus, varat izmantot šādu ar atstarpi atdalītu formātu:

[link text](url){: attribute="value" attribute2="value2" attribute3="value3"} 

Varat brīdināt lasītājus, ka saite novirzīs uz ārēju vietni, sintaksei pievienojot {: .external} .

Atsauces stila saitēs tiek izmantots otrs kvadrātiekavu komplekts, kurā ievietojat izvēlētu etiķeti, lai identificētu saiti:

This is [an example][id] reference-style link.

Pēc izvēles varat izmantot atstarpi, lai atdalītu iekavu kopas:

This is [an example] [id] reference-style link.

Pēc tam jebkurā dokumenta vietā jūs definējat savas saites etiķeti šādi, vienā rindā:

Saites URL pēc izvēles var ietvert leņķiekavās:

Nākamajā rindā varat ievietot virsraksta atribūtu un polsterēšanai izmantot papildu atstarpes vai tabulēšanas zīmes, kas parasti izskatās labāk, izmantojot garākus URL:

Saišu definīciju nosaukumos var būt burti, cipari, atstarpes un pieturzīmes, taču tie nav reģistrjutīgi. Piemēram, šīs divas saites:

[link text][a]
[link text][A]

ir līdzvērtīgi.

Netiešā saites nosaukuma saīsne ļauj izlaist saites nosaukumu, un tādā gadījumā kā nosaukums tiek izmantots pats saites teksts. Vienkārši izmantojiet kvadrātiekavās — piemēram, lai saistītu vārdu "Google" ar vietni google.com, varat vienkārši ierakstīt:

[Google]

Un pēc tam definējiet saiti:

Tā kā saišu nosaukumos var būt atstarpes, šī saīsne darbojas pat vairākiem vārdiem saites tekstā:

Visit [Daring Fireball] for more information.

Un pēc tam definējiet saiti:

Saišu definīcijas var ievietot jebkurā vietā Markdown dokumentā. Man ir tendence tos ievietot uzreiz aiz katras rindkopas, kurā tie tiek izmantoti, taču, ja vēlaties, varat tos visus ievietot dokumenta beigās, piemēram, zemsvītras piezīmēs.

Šeit ir darbības atsauces saišu piemērs:

I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].

Izmantojot netiešo saites nosaukuma saīsni, tā vietā varat rakstīt:

I get 10 times more traffic from [Google] than from
[Yahoo] or [MSN].




Abi iepriekš minētie piemēri radīs šādu HTML izvadi:

<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>

Salīdzinājumam šeit ir tā pati rindkopa, kas rakstīta, izmantojot Markdown iekļauto saites stilu:

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").

Markdown atbalsta saīsnes stilu, lai izveidotu "automātiskas" saites vietrāžiem URL un e-pasta adresēm: vienkārši ievietojiet URL vai e-pasta adresi ar leņķa iekavām. Tas nozīmē, ka, ja vēlaties parādīt URL vai e-pasta adreses faktisko tekstu, kā arī norādīt, ka tā ir noklikšķināma saite, varat rīkoties šādi:

<http://example.com/>

Markdown to pārvērtīs par:

<a href="http://example.com/">http://example.com/</a>

Automātiskās saites uz e-pasta adresēm darbojas līdzīgi, izņemot to, ka Markdown arī veiks nejaušu decimālo un heksadecimālo entītiju kodējumu, lai palīdzētu aizēnot jūsu adresi no adrešu savākšanas mēstuļu robotiem. Piemēram, Markdown pārvērtīs šo:

<address@example.com>

kaut kas līdzīgs šim:

<a href="&#x6D;&#x61;i&#x6C;&#x74;&#x6F;:&#x61;&#x64;&#x64;&#x72;&#x65;
&#115;&#115;&#64;&#101;&#120;&#x61;&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;
&#109;">&#x61;&#x64;&#x64;&#x72;&#x65;&#115;&#115;&#64;&#101;&#120;&#x61;
&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;</a>

kas pārlūkprogrammā tiks atveidots kā noklikšķināma saite uz "adrese@example.com".