جمعه , دی ۲۸ ۱۳۹۷
تسلط بر Markdown

تسلط بر Markdown

تسلط بر Markdown – فایل هایی با پسوند .md و یا .markdown را که معمولا برای ایجاد فایل  راهنمای یک مطلب(ReadMe) ایجاد می شود.

Markdown چیست؟

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

راهنمای سینتکس Markdown

ما در این قسمت یک بررسی مختصر از نحوه ایجاد فایل های markdown خواهیم داشت.

ایجاد تیتر به اندازه های 1 تا 6
# This is an <h1> tag
## This is an <h2> tag
### This is an <h3> tag
#### This is an <h4> tag
##### This is an <h5> tag
###### This is an <h6> tag
ایجاد قسمت Bold و Italic در متن
**This text will be bold**
__This will also be bold__
ایجاد لیست های بدون شماره
* Item 1
* Item 2
  * Item 2a
  * Item 2b
ایجاد لیست های شماره دار
1. Item 1
1. Item 2
1. Item 3
   1. Item 3a
   1. Item 3b
ایجاد تصویر
![Logo](/images/logo.png)
Format: ![Alt Text](url)
ایجاد لینک
[Text](http://link.com)
ایجاد نقل قول
As Kanye West said:

> We're living the future so
> the present is our past.
قرار کد وسط متن بصورت Inline Code
I think you should use an
`<addr>` element here instead.

ویژگی های اضافه markdown مختص گیت هاب (GFM)

GitHub.com از نسخه ی سفارشی خود از Markdown استفاده می کند که مجموعه ی دیگری از ویژگی های مفید را فراهم می کند. که بسیاری از آنها کار کردن با محیط گیت هاب را راحتر میکند.

نکته ای که وجد دارد این است که بسیاری از ویژگی های GitHub Flavored Markdown در قسمت های خاصی از گیت هاب مورد استفاده قرار میگیرد مثل descriptions comments of Issues و Pull Requests  بطور مثال @mentions در Issues و Pull Requests مورد استفاده قرار میگیرد. Task Lists همچنین استفاده میشوند در Gist comments و در Gist Markdown

نمایش تکه کد در GFM
```javascript
function fancyAlert(arg) {
  if(arg) {
    $.facebox({div:'#foo'})
  }
}
```

و همچنین میتوان با چهار اسپیس براحتی مشابه بالا عمل کرد.

function fancyAlert(arg) {
    if(arg) {
      $.facebox({div:'#foo'})
    }
  }
ایجاد چک باکس به عنوان تسک
- [x] @mentions, #refs, [links](), **formatting**, and <del>tags</del> supported
- [x] list syntax required (any unordered or ordered list supported)
- [x] this is a complete item
- [ ] this is an incomplete item
ایجاد جدول
First Header | Second Header
------------ | -------------
Content from cell 1 | Content from cell 2
Content in the first column | Content in the second column
SHA references

مشخص کردن رفرنس یک Commit خاص

16c999e8c71134401a78d4d46435517b2271d6ac
mojombo@16c999e8c71134401a78d4d46435517b2271d6ac
mojombo/github-flavored-markdown@16c999e8c71134401a78d4d46435517b2271d6ac
@mentions

منشن دادن به یک کاربر خاص ، تیم و یا سازمان درون متن

تبدیل خودکار هر url به لینک
خط زدن متن بوسیله تیلدر ~
Any word wrapped with two tildes (like ~~this~~) will appear crossed out.
استفاده از ایموجی ها

استفاده از ایموجی ها با قرار دادن بین دون نقطه

Emoji Cheat Sheet

:+1:

 

نسخه انگلیسی مقاله

 

تسلط بر Markdown

تسلط بر Markdown – تسلط بر Markdown

  • آیا این مقاله مفید بود؟
  • بله   خیر

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

۳ کامنت ها

  1. خیلی جالب بود استاد.
    قبلا نمی‌دونستم فایلهای md چطور ساخته میشن.
    باز هم تشکر و دست مریزاد به این دانش شما

  2. ممنون دم شما گرم

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد.