مارک داون به چه معناست؟ چگونه از نشانه گذاری نحوی/قالب بندی Markdown استفاده کنیم؟

منظور از مارک‌داون چیست ؟

چگونه از نشانه گذاری نحوی/قالب بندی Markdown استفاده کنیم؟

بررسی اجمالی

Markdown یک زبان نشانه گذاری سبک وزن است که توسط John Gruber ایجاد شده است.

این به افراد امکان می دهد اسناد را در قالب متن ساده بنویسند که خواندن و نوشتن آن آسان باشد و سپس آنها را به اسناد معتبر XHTML (یا HTML) تبدیل کنند.

این زبان بسیاری از ویژگی‌های نشانه‌گذاری متن ساده را که قبلاً در ایمیل یافت شده بود جذب کرده است.

جان گروبر زبان Markdown را در سال 2004 با همکاری آرون سوارتز تا حد زیادی در نحو ایجاد کرد.هدف این زبان استفاده از "فرمت متن ساده ای است که خواندن آن آسان است، نوشتن آن آسان است و به صورت اختیاری به XHTML (یا HTML) معتبر تبدیل می شود".

هدف

هدف Markdown "آسان خواندن و نوشتن آسان" است.

خوانایی بسیار مهم است؛ صرف نظر از اینکه چگونه بازاریابی آنلاین را انجام می‌دهید ، تجربه کاربری از اهمیت بالایی برخوردار است.

فایلی که در Markdown نوشته شده است باید بتواند مستقیماً به صورت متن ساده منتشر شود و به نظر نرسد که شامل بسیاری از برچسب ها یا دستورالعمل های قالب بندی باشد.

نحو Markdown تحت تأثیر برخی از قالب‌های موجود متن به HTML، از جمله Setext، atx، Textile، reStructuredText، Grutatext و EtText است، اما بزرگترین منبع الهام، قالب ایمیل متن ساده است.

به طور خلاصه، نحو Markdown همه از نمادهایی تشکیل شده است که با دقت انتخاب شده اند و عملکرد آنها در یک نگاه واضح است.به عنوان مثال: ستاره هایی را در اطراف متن قرار دهید تا شبیه *تأکید* شود.

لیست ها در Markdown شبیه لیست ها هستند. Blockquotes در Markdown واقعاً شبیه نقل قول از یک متن است، دقیقاً همانطور که در ایمیل‌ها دیده‌اید.

سازگار با HTML

هدف گرامر Markdown این است که زبان نوشتاری برای وب باشد.

Markdown قرار نیست جایگزین HTML شود یا حتی به آن نزدیک شود. Markdown برای سهولت در نوشتن اسناد HTML طراحی نشده است.

به نظر من، نوشتن HTML همین الان هم بسیار آسان است. فلسفه Markdown این است که خواندن، نوشتن و اصلاح اسناد را آسان‌تر کند. HTML یک قالب انتشار است، در حالی که Markdown یک قالب نوشتن سند است . بنابراین، سینتکس Markdown فقط محدوده‌ای را پوشش می‌دهد که متن ساده می‌تواند در بر بگیرد.

تگ‌هایی که توسط Markdown پوشش داده نمی‌شوند را می‌توان مستقیماً در سند HTML خود برای نوشتن متن تبلیغاتی آنلاین خود استفاده کرد . نیازی نیست صریحاً مشخص کنید که HTML است یا Markdown؛ فقط تگ‌ها را مستقیماً اضافه کنید.

فقط برخی از عناصر بلوک HTML محدود هستند - مانند <div>،<table>،<pre>،<p> و سایر تگ ها باید با خطوط خالی قبل و بعد از سایر قسمت های محتوا جدا شوند و تگ های باز و بسته شدن آنها با زبانه ها یا فاصله ها قابل تورفتگی نیست. مولد Markdown به اندازه کافی هوشمند است که تگ های غیر ضروری بلوک HTML را اضافه نمی کند <p> برچسب.

مثال به شرح زیر است، اضافه کردن یک جدول HTML به فایل Markdown:

这是一个普通段落。

<table>
    <tr>
        <td>Foo</td>
    </tr>
</table>

这是另一个普通段落。

توجه داشته باشید که دستور قالب بندی Markdown بین تگ های بلوک HTML پردازش نخواهد شد.به عنوان مثال، اگر از یک سبک Markdown در یک بلوک HTML استفاده می کنید*强调*تاثیری نخواهد داشت

تگ های بخش HTML (داخلی) مانند <span>،<cite>،<del> می توان آزادانه در پاراگراف ها، لیست ها یا سرفصل های Markdown استفاده کرد.طبق عادت های شخصی، حتی می توانید از تگ های HTML برای قالب بندی بدون استفاده از فرمت Markdown استفاده کنید.مثال: اگر HTML را ترجیح می دهید <a> یا <img> برچسب ها، که می توانند مستقیماً بدون پیوند یا نحو برچسب تصویر ارائه شده توسط Markdown استفاده شوند.

بر خلاف بین تگ های بلوک HTML، نحو Markdown بین تگ های بخش HTML معتبر است.

تبدیل خودکار کاراکترهای خاص

در فایل های HTML دو کاراکتر وجود دارد که نیاز به مدیریت خاصی دارند: < 和 & . < از نمادها برای تگ های شروع استفاده می شود،& از نمادها برای علامت گذاری موجودیت های HTML استفاده می شود، اگر فقط می خواهید نمونه اولیه این کاراکترها را نمایش دهید، باید از فرم موجودیت استفاده کنید، مانند < 和 &.

& اگر بخواهید تایپ کنید، کاراکترها مخصوصاً برای نویسندگان اسناد وب عذاب آور هستند.AT&T"، باید بنویسی"AT&T".در حالی که در URL & شخصیت ها نیز تبدیل می شوند.به عنوان مثال می خواهید به:

http://images.google.com/images?num=30&q=larry+bird

شما باید تبدیل URL را به صورت زیر بنویسید:

http://images.google.com/images?num=30&q=larry+bird

در تگ پیوند قرار داده شود href در خواصنیازی به گفتن نیست که نادیده گرفتن این امر آسان است و احتمالاً بیشترین تعداد خطا توسط اعتبارسنجی استانداردهای HTML شناسایی شده است.

Markdown به شما امکان می دهد کاراکترها را به طور طبیعی بنویسید، و از آنچه باید تبدیل شود مراقبت می کند.اگر استفاده می کنید & یک کاراکتر بخشی از یک موجودیت کاراکتر HTML است، همانطور که هست باقی می ماند، در غیر این صورت به آن تبدیل می شود &;.

بنابراین اگر می خواهید نماد حق چاپ را در سند درج کنید ©، می توانید بنویسید:

©

Markdown آن را دست نخورده باقی می گذارد.و اگر بنویسید:

AT&T

Markdown آن را به:

AT&T

وضعیت مشابهی نیز در < علامت گذاری، از آنجایی که Markdown اجازه می دهد تا سازگاری HTML را، اگر قرار دهید < نمادها به عنوان جداکننده برای تگ های HTML استفاده می شوند و Markdown هیچ تبدیلی روی آنها انجام نمی دهد، اما اگر بنویسید:

4 < 5

Markdown آن را به:

4 < 5

با این حال، باید توجه داشت که در محدوده کد، چه درون خطی باشد و چه بلوک، < 和 & هر دو نمادمطمئنابه موجودیت های HTML تبدیل می شوند، ویژگی که به شما امکان می دهد به راحتی کد HTML را در Markdown بنویسید (برخلاف HTML، جایی که همه موارد را در آن قرار می دهید. < 和 & همه به موجودیت های HTML تبدیل می شوند تا کد HTML در فایل HTML بنویسند. )

عنصر بلوک

پاراگراف ها و خطوط شکسته

یک پاراگراف Markdown از یک یا چند خط متنی متوالی تشکیل شده است که قبل و بعد از آن بیش از یک خط خالی وجود دارد (تعریف یک خط خالی این است که در صفحه نمایش خالی به نظر می رسد و به عنوان یک خط خالی در نظر گرفته می شود. به عنوان مثال، اگر یک خط فقط حاوی فاصله ها و برگه ها باشد، خط نیز به عنوان یک خط خالی در نظر گرفته می شود).پاراگراف های معمولی نباید با فاصله یا برگه ها تورفتگی داشته باشند.

عبارت "شامل یک یا چند خط متنی متوالی است" در واقع به این معنی است که Markdown اجازه می دهد خطوط جدید اجباری (درج خطوط جدید) در پاراگراف ها، ویژگی که با اکثر فرمت های متن به HTML دیگر متفاوت است (از جمله نوع متحرک "تبدیل خطوط شکسته" " گزینه)، فرمت های دیگر هر شکست خط را به <br /> برچسب.

اگر شمادر واقعمی خواهید برای درج به Markdown تکیه کنید <br /> برای برچسب ها، دو یا چند فاصله را در محل درج فشار دهید و سپس Enter را فشار دهید.

در واقع، برای تولید کمی کار بیشتر (فضاهای اضافی) لازم است <br /> ، اما به سادگی "هر خط جدید به <br />"روش در Markdown مناسب نیست، em در Markdownaiنقل قول‌های سبک L و فهرست‌های چند پاراگرافی نه تنها مفیدتر هستند، بلکه خواندن آنها هنگام حروفچینی با شکسته‌های خط آسان‌تر است.

عنوان

Markdown از دو نحو برای سرفصل ها پشتیبانی می کند، Setext-like و atx-like.

فرم Settext-مانند فرم با خط پایین است، با استفاده از = (بالاترین عنوان) و - (عناوین مرتبه دوم)، به عنوان مثال:

This is an H1
=============

This is an H2
-------------

هر مقدار = 和 - می تواند موثر باشد.

شکل Atx مانند 1 تا 6 را در ابتدای خط درج می کند # ، مربوط به عناوین 1 تا 6، به عنوان مثال:

# 这是 H1

## 这是 H2

###### 这是 H6

می توانید به صورت اختیاری هدرهای atx مانند را ببندید، این صرفاً برای زیبایی شناسی است، اگر از این طریق احساس راحتی می کنید، می توانید آن را در انتهای خط اضافه کنید. #، در حالی که خط به پایان می رسد # لزومی ندارد که عدد با ابتدا یکسان باشد (تعداد کاراکترهای پوندی در ابتدای خط ترتیب عنوان را تعیین می کند):

# 这是 H1 #

## 这是 H2 ##

### 这是 H3 ######

Blockquotes Blockquotes

بلوک‌های نشانه‌گذاری Markdown مشابه موارد مورد استفاده در ایمیل استفاده می‌شوند > از نقل قول هااگر با نقل قول ها در نامه های ایمیل آشنا هستید، می دانید که چگونه یک بلوک نقل قول در یک فایل Markdown ایجاد کنید، که به نظر می رسد خودتان خطوط را شکسته و سپس اضافه کنید. > :

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> 
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.

Markdown همچنین به شما این امکان را می دهد که تنبل باشید و فقط خط اول کل پاراگراف را اضافه کنید > :

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

ارجاعات بلوک را می توان با اضافه کردن تعداد متفاوتی از آنها تودرتو کرد (به عنوان مثال: ارجاعات درون مراجع). > :

> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

سایر نحوهای Markdown نیز می توانند در بلوک های نقل قول شده از جمله سرفصل ها، لیست ها، بلوک های کد و غیره استفاده شوند:

> ## 这是一个标题。
> 
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。
> 
> 给出一些例子代码：
> 
>     return shell_exec("echo $input | $markdown_script");

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

لیست

Markdown از لیست های مرتب و نامرتب پشتیبانی می کند.

لیست های نامرتب از ستاره، علامت مثبت یا منهای به عنوان نشانگر لیست استفاده می کنند:

*   Red
*   Green
*   Blue

معادل:

+   Red
+   Green
+   Blue

همچنین معادل:

-   Red
-   Green
-   Blue

لیست های مرتب شده از اعداد و به دنبال آن نقطه استفاده می کنند:

1.  Bird
2.  McHale
3.  Parish

مهم است که توجه داشته باشید اعدادی که در تگ لیست استفاده می کنید بر HTML خروجی تأثیر نمی گذارد.

<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>

اگر نشانه گذاری لیست شما به صورت زیر نوشته شده باشد:

1.  Bird
1.  McHale
1.  Parish

یا حتی:

3. Bird
1. McHale
8. Parish

هر دوی شما دقیقاً همان خروجی HTML را دریافت خواهید کرد.نکته این است که شما می توانید اعداد لیست را در فایل Markdown همانند نتایج خروجی قرار دهید یا اگر تنبل هستید، اصلاً نیازی نیست که به صحت اعداد اهمیت دهید.

اگر از نوشتن تنبل استفاده می کنید، توصیه می شود برای اولین مورد با 1 شروع کنید، زیرا Markdown ممکن است در آینده از ویژگی شروع لیست های مرتب شده پشتیبانی کند.

تگ مورد لیست معمولاً در سمت چپ قرار می گیرد، اما می توان آن را تا 3 فاصله ایجاد کرد و برچسب مورد باید حداقل با یک فاصله یا برگه دنبال شود.

برای اینکه لیست زیباتر به نظر برسد، می توانید مطالب را با یک تورفتگی ثابت سازماندهی کنید:

*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
    Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
    viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
    Suspendisse id sem consectetuer libero luctus adipiscing.

اما اگر تنبل هستید، این هم خوب است:

*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.

اگر موارد لیست با خطوط خالی از هم جدا شوند، Markdown از محتوای مورد هنگام خروجی HTML استفاده می کند. <p> برچسب ها بسته بندی می شوند، به عنوان مثال:

*   Bird
*   Magic

تبدیل خواهد شد به:

<ul>
<li>Bird</li>
<li>Magic</li>
</ul>

اما این:

*   Bird

*   Magic

تبدیل خواهد شد به:

<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>

آیتم های فهرست می توانند چندین پاراگراف داشته باشند و پاراگراف های زیر هر مورد باید با 4 فاصله یا 1 برگه تورفتگی داشته باشند:

1.  This is a list item with two paragraphs. Lorem ipsum dolor
    sit amet, consectetuer adipiscing elit. Aliquam hendrerit
    mi posuere lectus.

    Vestibulum enim wisi, viverra nec, fringilla in, laoreet
    vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
    sit amet velit.

2.  Suspendisse id sem consectetuer libero luctus adipiscing.

اگر هر خط را تورفتگی کنید خیلی بهتر به نظر می رسد، البته، دوباره، اگر تنبل هستید، Markdown همچنین اجازه می دهد:

*   This is a list item with two paragraphs.

    This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.

*   Another item in the same list.

اگر می خواهید یک مرجع را در یک آیتم لیست قرار دهید، پس > باید تورفتگی داشته باشد:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

اگر می‌خواهید یک بلوک کد را وارد کنید، آن بلوک باید دو بار تورفتگی داشته باشد ، که یا ۸ فاصله یا ۲ تب می‌شود:

*   一列表项包含一个列表区块：

        <代码写在这>

البته، لیستی از موارد ممکن است به طور تصادفی ایجاد شود، چیزی شبیه به این:

1986. What a great season.

به عبارت دیگر، برای جلوگیری از موقعیتی که در آن یک فاصله بین اعداد در ابتدای خط ظاهر می‌شود ، می‌توانید قبل از نقطه یک بک‌اسلش اضافه کنید.

1986\. What a great season.

بلوک کد

کد منبع نوشتار یا زبان برچسب مربوط به برنامه معمولاً دارای بلوک‌های کد تایپ‌شده است. معمولاً نمی‌خواهیم این بلوک‌ها مانند فایل‌های پاراگراف کلی تایپ شوند، بلکه آن‌ها را همانطور که هستند نمایش دهیم. Markdown از آن استفاده می‌کند. <pre> 和 <code> برچسب ها برای بسته بندی بلوک های کد.

ایجاد بلوک های کد در Markdown به سادگی تورفتگی 4 فاصله یا 1 تب است. به عنوان مثال، موارد زیر را وارد کنید:

这是一个普通段落：

    这是一个代码区块。

Markdown به موارد زیر تبدیل می شود:

<p>这是一个普通段落：</p>

<pre><code>这是一个代码区块。
</code></pre>

این تورفتگی مرتبه اول در هر خط (4 فاصله یا 1 برگه) حذف می شود، به عنوان مثال:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

تبدیل خواهد شد به:

<p>Here is an example of AppleScript:</p>

<pre><code>tell application "Foo"
    beep
end tell
</code></pre>

یک بلوک کد تا خط بدون فرورفتگی (یا انتهای فایل) ادامه می یابد.

در داخل بلوک کد، & ، < 和 > این به طور خودکار به موجودیت های HTML تبدیل می شود. این روش استفاده از Markdown را برای درج کد منبع HTML برای مثال بسیار آسان می کند، فقط آن را کپی و جایگذاری کنید، تورفتگی اضافه کنید، و بقیه Markdown آن را برای شما مدیریت می کند. مثال:

    <div class="footer">
        © 2004 Foo Corporation
    </div>

تبدیل خواهد شد به:

<pre><code><div class="footer">
    © 2004 Foo Corporation
</div>
</code></pre>

در بلوک کد، نحو عمومی Markdown تبدیل نمی شود، مانند ستاره ها فقط ستاره هستند، به این معنی که شما می توانید به راحتی فایل های مربوط به نحو Markdown را در نحو Markdown بنویسید.

تقسیم کننده

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

* * *

***

*****

- - -

---------------------------------------

عنصر بخش

ارتباط دادن

Markdown از دو نوع سینتکس لینک‌دهی پشتیبانی می‌کند: درون‌خطی (inline) و ارجاعی (reference).

در هر صورت، متن پیوند با [پرانتز مربع] علامت گذاری می شود.

برای ایجاد یک لینک درون‌خطی ، کافیست بعد از کروشه و پرانتز، آدرس اینترنتی (URL) را وارد کنید. اگر می‌خواهید متن عنوان را نیز به لینک اضافه کنید، کافیست متن عنوان را بعد از آدرس اینترنتی (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.

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

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

همچنین می توانید به صورت اختیاری بین دو براکت مربع فاصله بگذارید:

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

سپس، در هر نقطه از فایل، می توانید محتوای پیوند این تگ را تعریف کنید:

[id]: http://example.com/  "Optional Title Here"

محتوای پیوند به شکل زیر تعریف می شود:

• براکت های مربعی (به صورت اختیاری با حداکثر سه فاصله برای تورفتگی) که متن پیوند در آن وارد می شود
• به دنبال کولون
• به دنبال آن یک یا چند فاصله یا تب
• آدرس لینک بعدی
• به صورت اختیاری محتوای عنوان را دنبال کنید، که می تواند در یک نقل قول، دو نقل قول یا پرانتز قرار گیرد

تعاریف سه لینک زیر یکسان است:

[foo]: http://example.com/  "Optional Title Here"
[foo]: http://example.com/  'Optional Title Here'
[foo]: http://example.com/  (Optional Title Here)

لطفاً توجه داشته باشید: یک مشکل شناخته‌شده وجود دارد که Markdown.pl 1.0.1 عناوین لینک‌های قرار گرفته در داخل تک‌کوتیشن را نادیده می‌گیرد.

URL های پیوند را می توان در پرانتزهای زاویه ای نیز قرار داد:

[id]: <http://example.com/>  "Optional Title Here"

همچنین می‌توانید ویژگی title را در خط بعدی قرار دهید، یا مقداری تورفتگی اضافه کنید، که اگر URL خیلی طولانی باشد بهتر به نظر می‌رسد:

[id]: http://example.com/longish/path/to/resource/here
    "Optional Title Here"

تعریف URL فقط هنگام ایجاد پیوند استفاده می شود و مستقیماً در فایل ظاهر نمی شود.

شناسه‌های پیوند می‌توانند شامل حروف، اعداد، فاصله‌ها و علائم نگارشی باشند، اما به حروف کوچک و بزرگ حساس نیستند ؛ بنابراین، دو پیوند زیر یکسان هستند:

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

تگ‌های پیوند ضمنی به شما این امکان را می‌دهند که از مشخص کردن یک تگ پیوند صرف نظر کنید. در این حالت، تگ پیوند معادل متن پیوند در نظر گرفته می‌شود. برای استفاده از تگ‌های پیوند ضمنی، کافیست یک کروشه خالی بعد از متن پیوند اضافه کنید. اگر می‌خواهید "Google" به google.com پیوند دهد، می‌توانید آن را به صورت زیر ساده کنید:

[Google][]

سپس محتوای پیوند را تعریف کنید:

[Google]: http://google.com/

از آنجایی که متن پیوند ممکن است حاوی فضای خالی باشد، این نشانه گذاری ساده شده ممکن است حاوی چندین کلمه باشد:

Visit [Daring Fireball][] for more information.

سپس برای تعریف لینک ادامه دهید:

[Daring Fireball]: http://daringfireball.net/

تعریف لینک را می توان در هر جایی از فایل قرار داد، من ترجیح می دهم مستقیماً بعد از پاراگراف که لینک ظاهر می شود قرار دهم، همچنین می توانید آن را در انتهای فایل قرار دهید، درست مانند یک نظر.

در اینجا نمونه ای از پیوند مرجع آورده شده است:

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

  [1]: http://google.com/        "Google"
  [2]: http://search.yahoo.com/  "Yahoo Search"
  [3]: http://search.msn.com/    "MSN Search"

اگر آن را تغییر دهید تا از نام پیوند برای نوشتن استفاده کنید:

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

  [google]: http://google.com/        "Google"
  [yahoo]:  http://search.yahoo.com/  "Yahoo Search"
  [msn]:    http://search.msn.com/    "MSN Search"

دو روش نوشتن بالا 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").

در واقع، هدف پیوندهای به سبک مرجع این نیست که نوشتن آسانتر است، بلکه خواندن آن آسانتر است. مثال بالا را مقایسه کنید. مقاله به سبک مرجع خود فقط 81 کاراکتر دارد، اما فرم درون خطی به افزایش خواهد یافت. 176 کاراکتر، اگر با فرمت HTML خالص نوشته شود، 234 کاراکتر خواهد بود، در قالب HTML تعداد تگ ها بیشتر از متن است.

با استفاده از پیوندهای سبک مرجع Markdown، می توانید سند را بیشتر شبیه به نتیجه نهایی مرورگر کنید، به شما این امکان را می دهد که برخی از فراداده های مربوط به نشانه گذاری را به خارج از متن پاراگراف منتقل کنید، و می توانید پیوندها را بدون ایجاد حس خواندن مقاله اضافه کنید. .

اهمیت دادن

Markdown از ستاره استفاده می کند (*) و نتیجه نهایی (_) به عنوان نمادی برای علامت گذاری یک کلمه زیر خط دار، است * یا _ کلمات احاطه شده تبدیل به <em> احاطه شده توسط برچسب، با دو * یا _اگر پیچیده شود تبدیل به آن می شود <strong>،به عنوان مثال:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

تبدیل خواهد شد به:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

شما می توانید از هر سبکی که دوست دارید استفاده کنید، تنها محدودیت این است که می توانید از نماد برای باز کردن برچسب و نماد برای پایان دادن به آن استفاده کنید.

تاکید را می توان مستقیماً در وسط متن نیز درج کرد:

un*frigging*believable

ولیاگر شما * 和 _ اگر در هر دو طرف فضای خالی وجود داشته باشد، آنها فقط به عنوان نمادهای عادی در نظر گرفته می شوند.

برای درج ستاره یا زیرخط معمولی مستقیماً قبل و بعد از متن، می‌توانید از بک اسلش استفاده کنید:

\*this text is surrounded by literal asterisks\*

کد

اگر می خواهید قطعه کوچکی از کد درون خطی را علامت گذاری کنید، می توانید آن را در بکتیک بپیچید (`)،به عنوان مثال:

Use the `printf()` function.

تولید خواهد کرد:

<p>Use the <code>printf()</code> function.</p>

اگر می‌خواهید بک‌تیک‌ها را در یک بخش کد وارد کنید، می‌توانید بخش کد را با چندین بکتیک شروع و پایان دهید:

``There is a literal backtick (`) here.``

این نحو تولید می کند:

<p><code>There is a literal backtick (`) here.</code></p>

می‌توانید در ابتدا و انتهای یک بخش کد، یکی بعد از ابتدا و دیگری قبل از پایان، یک خالی قرار دهید، بنابراین می‌توانید بکتیک‌هایی را در ابتدای بخش وارد کنید:

A single backtick in a code span: `` ` ``

A backtick-delimited string in a code span: `` `foo` ``

تولید خواهد کرد:

<p>A single backtick in a code span: <code>`</code></p>

<p>A backtick-delimited string in a code span: <code>`foo`</code></p>

داخل قسمت کد،& و براکت های زاویه都به طور خودکار به موجودیت های HTML تبدیل می شود، که درج کد منبع HTML را آسان می کند، Markdown پاراگراف زیر را قرار می دهد:

Please don't use any `<blink>` tags.

به:

<p>Please don't use any <code><blink></code> tags.</p>

شما همچنین می توانید این را بنویسید:

`—` is the decimal-encoded equivalent of `—`.

برای تولید:

<p><code>—</code> is the decimal-encoded
equivalent of <code>—</code>.</p>

图片

بدیهی است که طراحی یک نحو "طبیعی" برای درج تصاویر در یک برنامه فقط متنی دشوار است.

Markdown از نحوی مشابه پیوندها برای نشانه‌گذاری تصاویر استفاده می‌کند و همچنین دو سبک را پشتیبانی می‌کند: درون‌خطی و ارجاعی.

نحو تصویر درون خطی به نظر می رسد:

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

جزئیات به شرح زیر است:

• یک علامت تعجب !
• به دنبال آن یک براکت مربع با متن جایگزین برای تصویر
• پس از آن پرانتزهای معمولی با URL تصویر، و در نهایت یک متن اختیاری «عنوان» در داخل نقل قول قرار می گیرد.

نحو تصویر مرجع به صورت زیر است:

![Alt text][id]

"id" نام مرجع تصویر است که به همان روش مرجع پیوند تعریف می شود:

[id]: url/to/image  "Optional title attribute"

تا اینجا Markdown راهی برای تعیین عرض و ارتفاع تصویر نداشته است، در صورت نیاز می توانید از حالت عادی استفاده کنید. <img> برچسب.

其 مربوط

لینک خودکار

Markdown از پردازش URL ها و صندوق های پستی ایمیل در قالب پیوندهای خودکار نسبتاً کوتاه پشتیبانی می کند.متن پیوند URL عمومی با آدرس پیوند یکسان است، به عنوان مثال:

<http://example.com/>

Markdown به موارد زیر تبدیل می شود:

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

پیوند خودکار آدرس‌های ایمیل نیز مشابه است، با این تفاوت که Markdown ابتدا یک فرآیند تبدیل رمزگذاری را انجام می‌دهد و کاراکترهای متن را به موجودیت‌های HTML هگزا دسیمال تبدیل می‌کند. این قالب می‌تواند برخی از روبات‌های جمع‌آوری آدرس ایمیل بد را فریب دهد، مانند:

<[email protected]>

Markdown به این موارد تبدیل می شود:

<a href="mailto:addre
[email protected]
m">address@exa
mple.com</a>

در مرورگر، این رشته (در واقع <a href="mailto:[email protected]">[email protected]</a>) یک پیوند قابل کلیک «[email protected]» می شود.

(اگرچه این روش می تواند بسیاری از ربات ها را فریب دهد، اما نمی تواند جلوی همه آنها را بگیرد، اما بهتر از هیچ است. در هر صورت، باز کردن صندوق پستی شما در نهایت نامه های تبلیغاتی را جذب می کند.)

بک اسلش

Markdown می تواند برای درج برخی از نمادها که معانی دیگری در گرامر دارند از علامت های عقب استفاده کند، به عنوان مثال: اگر می خواهید برای تأکید یک ستاره در کنار متن اضافه کنید (اما نه <em> برچسب)، می‌توانید قبل از ستاره با علامت بک اسلش قرار دهید:

\*literal asterisks\*

Markdown برای کمک به درج نمادهای رایج، از نمادهای زیر که قبل از آن یک بک اسلش قرار دارند، پشتیبانی می کند:

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

ویرایشگر رایگان Markdown

پلتفرم ویندوز

• MarkdownPad
• مارک پد

پلتفرم مک

• نرم

ویرایشگر آنلاین

• MPEditor

افزونه مرورگر

• افزونه Markdown here

*** اگر پیشنهاد بهتری برای ویرایشگرهای رایگان Markdown دارید، لطفاً به چن ویلیانگ اطلاع دهید . متشکرم!