الروابط

لإنشاء رابط مضمّن، استخدم مجموعة من الأقواس العادية مباشرةً بعد القوس المربع لإغلاق نص الرابط. داخل الأقواس، ضع عنوان 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

لإضافة سمة واحدة أو أكثر إلى رابط 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 وعناوين البريد الإلكتروني: ما عليك سوى إحاطة عنوان URL أو عنوان البريد الإلكتروني بأقواس زاوية. وهذا يعني أنك إذا كنت تريد عرض النص الفعلي لعنوان 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".