مارک داون به چه معناست؟ چگونه از نشانه گذاری نحوی/قالب بندی 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.

اگر می خواهید یک بلوک کد قرار دهید، بلوک باید تورفتگی داشته باشددو برابر، که 8 فاصله یا 2 زبانه است:

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

        <代码写在这>

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

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 از دو شکل نحو پیوند پشتیبانی می کند: درون خطی和ارجاعدو شکل

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

برای ایجاد یکدرون خطیاگر می‌خواهید متن عنوان پیوند را اضافه کنید، فقط متن عنوان را با دو علامت نقل قول بعد از 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 رایگان بهتری برای توصیه وجود دارد، لطفاً به بازخورد توجه کنیدچن ویلیانگ،با تشکر!