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

Markdown چیست؟

Markdown یا «متن مرتب» شیوه نمایش متن با علامت های ساده است، یک زبان نشانه گذاری سبک با ساختار تمام متن و کاربرد آسان برای نوشتن اسناد و محتوای وب که در نهایت به HTML ترجمه و با ساختار بندی نمایش داده میشه.

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

ساختار

فایل های مارک داون با پسوند .markdown یا بطور مختصر .md ذخیره میشن و ساختار و قواعدی برای نمایش محتوا دارن که در ادامه به شرح هر کدومشون با مثال میپردازم.

Headers

هدرها که عمدتا برای عناوین استفاده میشن و هدف از استفاده شون جلب توجه برای بخش های متفاوت صفحه هست رو میشه با قرار دادن نوشته مورد نظر بین ۲ علامت هش(hash mark) ایجاد کرد که یک روش ساده تر این هست که تنها علامت های هش قبل از عنوان رو بگذاریم و از علامت های هش بعد از عنوان خودداری کنیم.

نکته: برای ایجاد عنوان با سایزهای متفاوت میبایست علامت هش را به همان تعداد(۱ تا ۶) تکرار کرد.

Header 1
========

Header 2
--------

# Header 1
## Header 2
### Header 3
#### Header 4
##### Header 5
###### Header 6

Paragraph

برای ایجاد پاراگراف جدید کافیست مابین پاراگراف ها یک خط رو خالی بگذاریم.

This is first paragraph for our example.

This is the second paragraph.

Line Breaks

در مارک داون برای اینکه محتوای مورد نظرتون رو در خط جدید ادامه بدید
مثل همین خط بایستی در پایان خط قبلی ۲ فضای خالی(space) ایجاد نمایید.

Italic

برای ایتالیک کردن نوشته در Markdown میبایست کلمه را بین ۲ خط زیرین(underline) و یا ستاره(asterisks) قرار داد.

*Emphasis*
_Emphasis_

Bold

برای ذخیم کردن نوشته میبایست کلمه مابین ۲ تکرار ۲ ستاره(asterisks) و یا ۲ خط زیرین(underline) قرار داد.

**Bold**
__Bold__

نکته: ترجیحا برای ایتالیک کردن نوشته از خط زیرین و برای ذخیم کردن نوشته از ستاره استفاده کنید تا خوانایی متن هم بالا بره.

نکته: ایتالیک و ذخیم کردن متون دارای مفهوم بوده و صرفا برای زیبایی استفاده نمیگردند.

Strikethrough

برای نوشتن خطوط خط خورده متن را مابین ۲ تکرار علامت ~(tilde) قرار میدیم.

~~strikethrough text~~

Lists

لیست ها رو میشه به ۲ صورت لیست های مرتب و لیست های نامرتب و ترکیبی از ۲ لیست ایجاد کرد.

لیست های نامرتب

* Item
* Item
* Item
Or
- Item
- Item
- Item

لیست های مرتب

1. Item
2. Item

ترکیب لیست ها با هم

3. Item
	* Item
	* Item
4. Item

لینک ها رو در Markdown به ۲ صورت میشه ایجاد کرد که در ۲ حالت خروجی ها یکسان هستن.

اولین روش رو inline link میگن و به این صورت هست که متن لینک رو درون کروشه(brackets) قرار میدیم و خود لینک رو داخل پرانتز میگذاریم.

[link text](http://example.com)

روش دوم رو reference link میگن و همونطور که از اسمش بر میاد لینک یک مرجع هست به یک آدرس یا صفحه دیگه و بصورت ۲ تا کروشه در کنار هم استفاده میشه. کروشه اول حاوی متن لینک و کروشه دوم حاوی ریفرنس اون آدرس/لینک هست.

Here is [first link] [1stLink] and here is the [second link][2ndLink]

[1stLink]: http://example.com
[2ndLink]: http://secondexample.com

Images

برای تصاویر هم مثل لینک ها به دو صورت inline و reference میشه عمل کرد و اون ها رو به اسناد اضافه کرد.

![Alt](/img/picture.jpg "Image Title")

![Alt][1]
[1]: /img/picture.jpg "Image Title"

[![Alt text](/img/picture.png "Image Title")](http://example.com/ "Link Title")

Blockquotes

با استفاده از علامت بزرگ تر میتونیم متن دلخواهمون رو در قابل نقل قول نمایش بدیم.

> Quoted text.
> > Quoted quote. (nested)

> * Quoted
> * List

Code Spans

لیست نمایش کدها میتواند inline و یا به صورت بلاک باشد.

کد درون خطی(inline code)

`<code>`

بلاک کد(code block)

\~~~
This is a
piece of code
in a block
\~~~

نکته: در مثال فوق جهت جلوگیری از اعمال دستور از \ (back slash) استفاده شده که شما در زمان استفاده میبایست اونها رو از نادیده بگیرید .

```
This is another
way to create
code block
```

Tables

در مثال های زیر هر چند هر دو خروجی مشابهی دارند اما مثال دوم باعث زیبایی ساختار سند مارک داون ما نیز میشود.

First Header | Second Header
----------------- | --------------------
Content from cell 1 | Content from cell 2
Content in the first column | Content in the second column

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

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

Horizontal Rules

برای ایجای خط افقی میتونید از Hyphens، Asterisks و یا Underscores استفاده کنید.

---
Hyphens

***
Asterisks

___
Underscores

Abbreviations

برای نمایش عبارت های مخفف شده در متون میتونید از مثال زیر استفاده کنید.
در این حالت با قرار گرفتن موس به روی کلمه مخفف شده عبارت کامل آن نمایش داده میشه.

Markdown converts text to HTML.

[HTML]: HyperTextMarkupLanguage

Footnotes

گاهی همچون کتاب ها و مقاله های چاپی لازم دارید تا توضیحاتی در رابطه با عبارت یا مساله ای در پایین صفحه به خواننده ارائه بدید برای چنین مواقعی میتونید از footnateها استفاده کنید.

I have more [^1] to say up here.

[^1]: To say down here.

Task Lists

لیست کارها(to do) رو میتونید به صورت زیر توی سند خودتون ایجاد کنید

### Task list title

- [x] this is a complete item
- [ ] this is an incomplete item
- [x] To be done ASAP
- [ ] Something to do
- [ ] Or what ever you need

Emoji

استفاده از شکلک ها(emoji) در مارک داون هم امکان پذیر هست فقط کافیه توی سندتون از کد اونها استفاده کنید تا در زمان مشاهده سند اون ها رو ببینید. به صفحه برگه تقلب شکلک ها برید و کد شون رو ببینید.

در پایان این نکته رو بگم که قابلیت های ذکر شده رو همه جا پشتیبانی نمیکنن چرا که بعضا توسط برخی سایت ها توسعه داده شدن، همچنین چنانچه امکانی رو می بینید که مارک داون پشتیبانی میکنه و اینجا ذکر نشده، می تونید اون رو در قسمت نظرهای مطلب برای من ارسال کنید و در جهت تکمیل و هر چه غنی تر شدن مطلب کمک کنید.

لینک های مفید

منابع