Συνδέσεις

Για να δημιουργήσετε έναν ενσωματωμένο σύνδεσμο, χρησιμοποιήστε ένα σύνολο κανονικών παρενθέσεων αμέσως μετά το κλείσιμο του κειμένου του συνδέσμου. Μέσα στις παρενθέσεις, τοποθετήστε τη διεύθυνση URL στο σημείο που θέλετε να δείχνει ο σύνδεσμος, μαζί με έναν προαιρετικό τίτλο για τον σύνδεσμο, που περιβάλλεται σε εισαγωγικά. Για παράδειγμα:

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

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

Θα παράγει:

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

Εάν αναφέρεστε σε έναν τοπικό πόρο στον ίδιο διακομιστή, μπορείτε να χρησιμοποιήσετε σχετικές διαδρομές:

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

Καθορισμός χαρακτηριστικών HTML στο markdown

Για να προσθέσετε ένα ή περισσότερα χαρακτηριστικά σε έναν σύνδεσμο σήμανσης, μπορείτε να χρησιμοποιήσετε την ακόλουθη μορφή οριοθετημένη με χώρο:

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

Μπορείτε να ειδοποιήσετε τους αναγνώστες ότι ένας σύνδεσμος θα οδηγήσει σε έναν εξωτερικό ιστότοπο προσθέτοντας {: .external} στη σύνταξη.

Οι σύνδεσμοι τύπου αναφοράς χρησιμοποιούν ένα δεύτερο σύνολο αγκύλων, μέσα στις οποίες τοποθετείτε μια ετικέτα της επιλογής σας για να προσδιορίσετε τον σύνδεσμο:

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

Μπορείτε προαιρετικά να χρησιμοποιήσετε ένα κενό για να διαχωρίσετε τα σύνολα παρενθέσεων:

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

Στη συνέχεια, οπουδήποτε στο έγγραφο, ορίζετε την ετικέτα του συνδέσμου σας ως εξής, σε μια γραμμή από μόνη της:

Η διεύθυνση URL του συνδέσμου μπορεί, προαιρετικά, να περιβάλλεται από αγκύλες:

Μπορείτε να βάλετε το χαρακτηριστικό τίτλος στην επόμενη γραμμή και να χρησιμοποιήσετε επιπλέον κενά ή καρτέλες για αναπλήρωση, κάτι που τείνει να φαίνεται καλύτερο με μεγαλύτερες διευθύνσεις URL:

Τα ονόματα ορισμού συνδέσμων μπορεί να αποτελούνται από γράμματα, αριθμούς, κενά και σημεία στίξης -- αλλά δεν κάνουν διάκριση πεζών-κεφαλαίων. Πχ αυτοί οι δύο σύνδεσμοι:

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

είναι ισοδύναμα.

Η σιωπηρή συντόμευση ονόματος συνδέσμου σάς επιτρέπει να παραλείψετε το όνομα του συνδέσμου, οπότε το ίδιο το κείμενο του συνδέσμου χρησιμοποιείται ως όνομα. Απλώς χρησιμοποιήστε ένα σύνολο αγκύλων -- π.χ., για να συνδέσετε τη λέξη "Google" στον ιστότοπο google.com, θα μπορούσατε απλώς να γράψετε:

[Google]

Και μετά ορίστε τον σύνδεσμο:

Επειδή τα ονόματα συνδέσμων μπορεί να περιέχουν κενά, αυτή η συντόμευση λειτουργεί ακόμη και για πολλές λέξεις στο κείμενο του συνδέσμου:

Visit [Daring Fireball] for more information.

Και μετά ορίστε τον σύνδεσμο:

Οι ορισμοί συνδέσμων μπορούν να τοποθετηθούν οπουδήποτε στο έγγραφο Markdown. Τείνω να τα βάζω αμέσως μετά από κάθε παράγραφο στην οποία χρησιμοποιούνται, αλλά αν θέλετε, μπορείτε να τα βάλετε όλα στο τέλος του εγγράφου σας, κάτι σαν υποσημειώσεις.

Ακολουθεί ένα παράδειγμα συνδέσμων αναφοράς σε δράση: 

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

Χρησιμοποιώντας τη συντόμευση του άρρητου ονόματος συνδέσμου, θα μπορούσατε να γράψετε: 

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

Και τα δύο παραπάνω παραδείγματα θα παράγουν την ακόλουθη έξοδο HTML: 

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

Για σύγκριση, εδώ είναι η ίδια παράγραφος γραμμένη χρησιμοποιώντας το στυλ ενσωματωμένου συνδέσμου Markdown: 

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 υποστηρίζει ένα στυλ συντόμευσης για τη δημιουργία "αυτόματων" συνδέσμων για διευθύνσεις URL και διευθύνσεις email: απλώς περιβάλετε τη διεύθυνση URL ή τη διεύθυνση email με γωνιακές αγκύλες. Αυτό σημαίνει ότι εάν θέλετε να εμφανίσετε το πραγματικό κείμενο μιας διεύθυνσης URL ή μιας διεύθυνσης ηλεκτρονικού ταχυδρομείου και επίσης να είναι ένας σύνδεσμος με δυνατότητα κλικ, μπορείτε να το κάνετε αυτό: 

<http://example.com/>

Το Markdown θα το μετατρέψει σε: 

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

Οι αυτόματοι σύνδεσμοι για διευθύνσεις ηλεκτρονικού ταχυδρομείου λειτουργούν με παρόμοιο τρόπο, εκτός από το ότι το Markdown θα εκτελέσει επίσης μια τυχαία κωδικοποίηση δεκαδικών και δεκαεξαδικών οντοτήτων για να αποκρύψετε τη διεύθυνσή σας από ανεπιθύμητα μηνύματα που συγκεντρώνουν διευθύνσεις. Για παράδειγμα, ο Markdown θα μετατρέψει αυτό: 

<address@example.com>

σε κάτι σαν αυτό: 

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

το οποίο θα αποδοθεί σε ένα πρόγραμμα περιήγησης ως σύνδεσμος με δυνατότητα κλικ στη διεύθυνση "address@example.com".