راهنمای نحو Markdown
نحو ضروری برای قالببندی اسناد شما
نمای کلی
Markdown یک زبان نشانهگذاری سبک است که میتوانید برای افزودن عناصر قالببندی به اسناد متن ساده استفاده کنید. ساختهشده توسط John Gruber در ۲۰۰۴، Markdown اکنون یکی از محبوبترین زبانهای نشانهگذاری جهان است.
استفاده از Markdown با ویرایشگر WYSIWYG فرق دارد. در اپلیکیشنی مثل Microsoft Word دکمه میزنید تا کلمات و عبارات را قالببندی کنید و تغییرات فوراً دیده میشود. Markdown اینطور نیست. وقتی فایل قالببندیشده Markdown میسازید، نحو Markdown را به متن اضافه میکنید تا مشخص کنید کدام کلمات و عبارات باید متفاوت بهنظر برسند.
عناوین
برای ساخت عنوان، قبل از کلمه یا عبارت علامت شماره (#) بگذارید. تعداد # باید با سطح عنوان مطابقت داشته باشد. مثلاً برای سطح سه: ### عنوان من.
Heading level 1
Heading level 2
Heading level 3
Heading level 4
Heading level 5
Heading level 6
پاراگرافها
برای پاراگراف، از خط خالی برای جدا کردن یک یا چند خط متن استفاده کنید.
It lets me write easily.
<p>It lets me write easily.</p>
I really like using Markdown.
It lets me write easily.
شکست خط
برای شکست خط یا خط جدید، خط را با دو یا چند فاصله تمام کنید و Enter بزنید.
And this is the second line.
And this is the second line.</p>
This is the first line.
And this is the second line.
تأکید
میتوانید با پررنگ یا مورب کردن متن تأکید اضافه کنید.
پررنگ
برای پررنگ، دو ستاره (**) یا زیرخط (__) قبل و بعد از کلمه یا عبارت بگذارید.
I just love bold text.
I just love bold text.
مورب
برای مورب، یک ستاره (*) یا زیرخط (_) قبل و بعد از کلمه یا عبارت بگذارید.
The cat meows.
The cat meows.
پررنگ و مورب
برای تأکید همزمان پررنگ و مورب، سه ستاره (***) یا زیرخط (___) قبل و بعد بگذارید.
This text is really important.
This text is really important.
بلوک نقلقول
برای بلوک نقلقول، > قبل از پاراگراف بگذارید.
Dorothy followed her through many of the beautiful rooms in her castle.
بلوک نقلقول تودرتو
بلوک نقلقول را میتوان تودرتو کرد. >> قبل از پاراگرافی که میخواهید تودرتو شود بگذارید.
>
>> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
Dorothy followed her through many of the beautiful rooms in her castle.
The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
لیستها
میتوانید آیتمها را در لیست مرتب و نامرتب سازماندهی کنید.
لیستهای مرتب
برای لیست مرتب، خطها را با عدد و نقطه اضافه کنید. اعداد حتماً ترتیب عددی ندارند ولی لیست باید با یک شروع شود.
2. Second item
3. Third item
4. Fourth item
<li>First item</li>
<li>Second item</li>
<li>Third item</li>
<li>Fourth item</li>
</ol>
- First item
- Second item
- Third item
- Fourth item
لیستهای نامرتب
برای لیست نامرتب، خط تیره (-)، ستاره (*) یا بعلاوه (+) قبل از خطها بگذارید.
- Second item
- Third item
- Fourth item
<li>First item</li>
<li>Second item</li>
<li>Third item</li>
<li>Fourth item</li>
</ul>
- First item
- Second item
- Third item
- Fourth item
کد
برای مشخص کردن کلمه یا عبارت بهعنوان کد، آن را در backtick (`) بگذارید.
At the command prompt, type nano.
بلوکهای کد
برای بلوک کد، هر خط را حداقل چهار فاصله یا یک تب تورفتگی بدهید، یا سه backtick (```) قبل و بعد از بلوک بگذارید.
{
"firstName": "John",
"lastName": "Smith",
"age": 25
}
```
{
"firstName": "John",
"lastName": "Smith",
"age": 25
}خطوط افقی
برای خط افقی، سه ستاره (***)، خط تیره (---) یا زیرخط (___) در یک خط تنها استفاده کنید.
لینکها
برای لینک، متن لینک را در براکت (مثلاً [Duck Duck Go]) و بلافاصله URL را در پرانتز (مثلاً (https://duckduckgo.com)) بگذارید.
My favorite search engine is Duck Duck Go.
افزودن عنوان
میتوانید اختیاری برای لینک عنوان بگذارید. بهصورت tooltip وقتی کاربر روی لینک برود نمایش داده میشود. عنوان را بعد از URL در گیومه بگذارید.
My favorite search engine is Duck Duck Go.
تصاویر
برای تصویر، علامت تعجب (!)، بعد متن جایگزین در براکت و مسیر یا URL تصویر در پرانتز بگذارید. اختیاری عنوان را در گیومه بعد از مسیر یا URL بگذارید.
فرار کاراکتر
برای نمایش کاراکتر تحتاللفظی که در سند Markdown برای قالببندی استفاده میشود، backslash (\) قبل از کاراکتر بگذارید.
* Without the backslash, this would be a bullet in an unordered list.
کاراکترهایی که میتوان فرار داد
میتوانید از backslash برای فرار این کاراکترها استفاده کنید:
| \ | backslash |
| ` | backtick |
| * | asterisk |
| _ | underscore |
| { } | curly braces |
| [ ] | brackets |
| ( ) | parentheses |
| # | pound sign |
| + | plus sign |
| - | minus sign (hyphen) |
| . | dot |
| ! | exclamation mark |
| | | pipe |
جداول
برای جدول، سه خط تیره (---) یا بیشتر برای هدر هر ستون و لوله (|) برای جدا کردن ستونها استفاده کنید. اختیاری لوله در دو سر جدول بگذارید.
| --------- | ----------- |
| Header | Title |
| Paragraph | Text |
| Syntax | Description |
|---|---|
| Header | Title |
| Paragraph | Text |
تراز
میتوانید متن ستونها را چپ، راست یا وسط تراز کنید با گذاشتن دو نقطه (:) چپ، راست یا دو طرف خط تیره در ردیف هدر.
| :--- | :---: | ---: |
| This | This | This |
| column | column | column |
| will | will | will |
| align | align | align |
| left | center | right |
| تراز چپ | وسط | تراز راست |
|---|---|---|
| This | This | This |
| column | column | column |
| will | will | will |
| align | align | align |
| left | center | right |