مولّد روابط ماركداون

الأشكال الأربعة للروابط

داخل السطر، بدون عنوان:

[اقرأ الوثائق](https://example.com/docs)

داخل السطر مع عنوان (تلميح عند تمرير المؤشر):

[اقرأ الوثائق](https://example.com/docs "الوثائق الكاملة")

النمط المرجعي (عنوان URL معرّف أدناه):

افتح [الوثائق][docs] أو [سجل التغييرات][cl].

[docs]: https://example.com/docs
[cl]:   https://example.com/changelog

رابط تلقائي (عنوان URL هو النص والوجهة معًا):

<https://example.com>

متى تختار كل نمط

• داخل السطر للروابط العرضية حين يكون عنوان URL قصيرًا وتظل الفقرة مقروءة جيدًا.
• النمط المرجعي حين تستشهد بنفس عنوان URL عدة مرات، أو حين يكون العنوان سلسلة تتبّع وحشية من 200 حرف قد تُخلّ بتدفق الفقرة لولا ذلك.
• الرابط التلقائي لعبارة مثل «هذه صفحة وثائقنا» حين تريد فعلًا أن يظهر عنوان URL كنص ووجهة في آنٍ واحد.

التعامل مع الأحرف الخاصة

• المسافات في عناوين URL تحتاج إلى %20 وإلا انقطع الرابط عند المسافة.
• الأقواس الدائرية في عنوان URL تحتاج إلى ترميز URL على هيئة %28 و%29، وإلا ابتلعها محلل ماركداون.
• الأقواس المربعة في نص الرابط يجب تهريبها على هيئة \[ و\] لمنع المحلل من معاملتها كصيغة رابط متداخلة.

نصائح إمكانية الوصول

• تجنّب «انقر هنا». نص رابط مثل انقر هنا أو اقرأ المزيد عديم الفائدة حين يتنقّل مستخدمو قارئات الشاشة بين الروابط. استخدم نصًا وصفيًا: [دليل التثبيت](...).
• لا تضع عنوان URL نفسه كنص رابط للعناوين الطويلة؛ فذلك غير ملائم للتقنيات المساعِدة ويبدو رديئًا عند الطباعة.
• «فتح في علامة تبويب جديدة» هو HTML خام (target="_blank") وليس ماركداون. معظم برامج العرض التي تقبل HTML الخام ستحترمه؛ أما CommonMark الصرف فلا.

اختصار من سطر واحد

في تعليقات GitHub، يؤدي لصق عنوان URL بجوار نص محدد إلى تحويله تلقائيًا إلى رابط ماركداون. مفيد حين تكون بالفعل داخل المحرّر.