پیوندها

برای ایجاد یک پیوند درون خطی، از مجموعه ای از پرانتزهای معمولی بلافاصله بعد از بسته شدن کروشه متن پیوند استفاده کنید. داخل پرانتز، نشانی اینترنتی را در جایی که می‌خواهید پیوند نشان دهد، به همراه یک عنوان اختیاری برای پیوند، که در گیومه احاطه شده است، قرار دهید. به عنوان مثال:

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 در علامت گذاری

برای افزودن یک یا چند ویژگی به یک پیوند علامت گذاری، می توانید از فرمت با فاصله محدود زیر استفاده کنید:

[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 پیوند ممکن است به صورت اختیاری با براکت های زاویه احاطه شود:

می‌توانید ویژگی title را در خط بعدی قرار دهید و از فضاها یا برگه‌های اضافی برای padding استفاده کنید، که با 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" ارائه می شود.