زبان markdown چیه و چه کاربردی داره؟

شاید تا به حال به فایل‌هایی با پسوند md برخورد کرده باشید. پرکاربردترین فایل‌های md، فایل‌های README در گیت هاب هستند. زبان markdown یک زبان ساده است که برای نوشتن مستندات گوناگون مانند گزارش‌ها کاربرد دارد. جالب است بدانید پاسخ ربات چت جی پی تی به سوالات شما به همین زبان نوشته شده و خروجی آن به شما نمایش داده می‌شود.

قواعد نگارشی (syntax)

- عناوین اصلی

# H1
## H2
### H3
#### H4
##### H5
###### H6

- بولد کردن نوشته

**bold text**

- ایتالیک نوشتن

*italic text*

- برای قرار دادن قطعه کد چند خطی از ``` استفاده کرده و زبان قطعه کد را نیز ذکر کنید تا کلمات کلیدی زبان هایلایت شوند.

```python
print("Hello world")
```

- هایلایت کردن یک عبارت

`highlight`

- لینک

[title](example.com)

- تصویر

![alt text](image.jpg)

- جدول

| title 1 | title 2 |
|:-------:|:----------:|
| content 1 | content 2|
|content 3 | content 4 |

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

موارد ذکر شده از پرکاربردترین قواعد نوشتاری زبان markdown هستند. برای دیدن همه قواعد به مستندات این زبان مراجعه کنید.

مشاهده خروجی

می‌توانید در Visual Studio Code، کد را نوشته و با کلیک راست روی فایل کد و انتخاب گزینه‌ی Open Preview خروجی را مشاهده کنید.

البته ابزارهای آنلاینی مانند dillinger هم برای مشاهده‌ی خروجی این مستندات استفاده می‌شوند.

ساخت فهرست عناوین در مستندات markdown

در بالای هر عنوان اصلی که قصد اضافه کردن آن به فهرست خود را دارید، یک تگ a اضافه کنید و اتریبیوت name را برابر با عنوان قرار دهید.

<a name="This is the main heading"></a>

# This is the main heading

حالا در بالای صفحه، جایی که قصد دارید فهرست مطالب را قرار دهید، یک فهرست از لینک‌هایی به تگ‌های a بسازید.

* [This is the main heading](#this-is-the-main-heading)

نوشتن فرمول‌های ریاضیات در markdown

برای نوشتن این فرمول‌ها ابتدا باید اکستنشن markdown + math را دانلود و نصب کنید.

حالا با توجه به قواعد نوشتاری موجود در این صفحه می‌توانید فرمول‌ها و عناصر ریاضی مانند ماتریس‌ها را به راحتی نمایش دهید.

نکته: فرمول‌های ریاضی که در یک خط قرار می‌گیرند باید بین دو $ و فرمول‌هایی که در بیش از یک خط قرار می‌گیرند باید بین دو $$ قرار بگیرند.

$$
\begin{matrix}
 a & b \\
 c & d
\end{matrix}
$$
$\left( \frac{x}{y} \right)$

چطور فایل markdown را به فایل پی دی اف تبدیل کنیم؟

اول از همه باید اکستنشن Markdown PDF را در Visual Studio Code دانلود و نصب کنید.

حالا در فایل md، راست کلیک کنید و نوع فایل خروجی (pdf, jpg, html, png) را انتخاب کنید.

بعد از چند لحظه فایل خروجی شما آماده است!