persian.md

آموزش زبان Markdown (فارسی)

اینجا زبان markdown را یادبگیرید.

• هدینگ یا سربرگ

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

داخل HTML از تگ های هدینگ از یک تا شش استفاده میشود. یعنی <h1></h1> تا 6. اما از # در MD استفاده میشود.

HTML:

<h1>سربرگ</h1>
<h2>سربرگ</h2>
<h3>سربرگ</h3>
<h4>سربرگ</h4>
<h5>سربرگ</h5>
<h6>سربرگ</h6>

خروجی:

سربرگ

سربرگ

سربرگ

سربرگ

سربرگ

سربرگ

چطوری اینا رو توی Markdown استفاده کنیم؟

Markdown:

# سربرگ
## سربرگ
### سربرگ
#### سربرگ
##### سربرگ
###### سربرگ

خروجی:

سربرگ

سربرگ

سربرگ

سربرگ

سربرگ

سربرگ

همانطور که دیدید، از # به جای تگ ها استفاده میکنیم. اگر هدینگ ما h2 بود پس از ## استفاده میشود.

---

• استایل متن

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

ما داخل HTML تگ های مخصوص را داریم که در اینجا دیگر نیازی به آنها نیست. برای مثال بولد کردن. فقط از ** استفاده میشود.

HTML:

من <b>امیر</b> هستم. از آشنایی با <b>شما</b> خوشبختم.

خروجی:

من امیر هستم. از آشنایی با شما خوشبختم.

داخل MD تغییر زیادی ندارد.

Markdown:

من **امیر** هستم. از آشنایی با **شما** خوشبختم.

خروجی:

من امیر هستم. از آشنایی با شما خوشبختم.

اما ولی چطوری حالا متن رو ایتالیک کنیم؟ فقط کافیه از یه ستاره استفاده کنیم! *.

HTML:

اون گفت <i>من عاشق استفاده از گیت هستم</i>.

خروجی:

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

داخل MD هم خروجی فرقی نمیکنه.

Markdown:

اون گفت *من عاشق استفاده از گیت هستم*.

خروجی:

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

---

• لینک ها

شاید لازم باشه داخل متن از لینک استفاده کنید. از HTML کمک میگیرید؟ این کار رو همین الان بزارید کنار!

ما الان به سینتکس لینک دهی توی Markdown آشنا میشویم.

HTML:

ورود به <a href="https://google.com">گوگل</a>

خروجی:

ورود به گوگل

Markdown:

[گوگل](https://google.com) ورود به

ورود به گوگل

راحت یه لینک درست کردیم. داخل [], اسم رو بزارید و داخل () لینک رو بزارید.

---

• عکس ها

واقعا از قرار دادن عکس ها خوشم میاد. چون هم ساده هست و هم سریع. اما ولی خب چطوری!؟

HTML:

<img alt="Tree" src="https://wallpapercave.com/wp/wp3385761.jpg">

خروجی:

داخل MD خیلی ساده تره. فقط دقت کنید.

Markdown:

[![Image Alt](image url)](link of picture)

در اولین نگاه یاد چی می افتید؟ بله، لینک ها. اما با این تفاوت که یکم تغییر کرده! چند قسمت جدید داره. متن عکس، لینک عکس.

خب، ![image alt](image url) میشه تیکه اول یا پارت اول اون سینتکس. یعنی قسمتی که ما لینک عکس رو وارد میکنیم و میگیم که اگه عکس باز نشد متن چی باشه. متن نمایش داده شده میشه Image Alt و لینک عکس هم میشه image url.

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

این روش استفاده از عکس ها بود.

---

• لیست ها

ما دو نوع لیست داریم. ترتیبی و غیر ترتیبی. داخل HTML این دو نوع وجود دارد. اما ولی داخل Markdown فقط غیر ترتیبی وجو دارد.

HTML:

<ul>
    <li>آیتم 1</li>
    <li>آیتم 2</li>
    <li>آیتم 3</li>
</ul>

خروجی:

• آیتم 1
• آیتم 2
• آیتم 3

و فقط داخل markdown از - استفاده میکنیم.

Markdown:

- آیتم 1
- آیتم 2
- آیتم 3

چقدر ساده بود؟ خیلی زیاد!

---

• لیست های ترتیبی

حتی لیست های ترتیبی‌ هم داریم!

Markdown:

1. آیتم 1
    1. آیتم 2
2. آیتم 2
    1. آیتم 2
3. آیتم 3
    1. آیتم 3

خروجی:

1. آیتم 1
   1. آیتم 2
2. آیتم 2
   1. آیتم 2
3. آیتم 3
   1. آیتم 3

این بود لیست های ترتیبی :)

آیا واضح بود!؟

---

• لیست های تودرتو

ما همه میدونیم لیست های تودرتور به چه صورت هستند. اما ولی چطوری یکی بسازیم؟

- آیتم 1
    - ساب آیتم 1
- آیتم 2
    - ساب آیتم 2
- آیتم 3
    - ساب آیتم 3

• آیتم 1
  • ساب آیتم 1
• آیتم 2
  • ساب آیتم 2
• آیتم 3
  • ساب آیتم 3

حتی عمیق تر شوید!

- آیتم 1
    - ساب آیتم 1
        - ساب ساب آیتم 1
- آیتم 2
    - ساب آیتم 2
        - ساب ساب آیتم 2
- آیتم 3
    - ساب آیتم 3
        - ساب ساب آیتم 3

• آیتم 1
  • ساب آیتم 1
    • ساب ساب آیتم 1
• آیتم 2
  • ساب آیتم 2
    • ساب ساب آیتم 2
• آیتم 3
  • ساب آیتم 3
    • ساب ساب آیتم 3

این بود لیست های تودرتو.

---

• هایلایت ها

وقتشه که بخشی رو توضیح بدیم که خیلی خوشم میاد ازش. اون هم هایلایت ها میباشد. هایلایت های بلاکی و حتی هایلایت های خطی.

ابتدا در باره هایلایت خطی صحبت میکنیم. همچین چیزی داخل HTML وجود ندارد. پس مستقیم میریم سراغ کد Markdown.

این یک `متن هایلایت شده` مباشد.

خروجی:

این یک متن هایلایت شده مباشد.

خب ما هایلایت خطی را یادگرفتیم. پس چطوری همچین چیزی رو میتونیم بسازیم؟ :

from platform import system as pltfrm
from os import system as sstm

if pltfrm().lower() == "windows":
    sstm("cls")
elif pltfrm().lower() == "linux":
    sstm("clear")
else:
    sstm("clear")

خیلی ساده. به نمونه کد زیر دقت کنید.

خب، name چیست؟‌نام همان اسم زبان میباشد که ما کد آن را مینویسیم. آن بلاک، یک بلاک پایتون بود. پس از پایتون رو به روی ``` استفاده شد.

اتمام هایلایت ها!

---

• تودو ها

از تودو ها در markdown استفاده کنید.

• رفتن به مدرسه
• خرید لامپ
• شستن دست ها

- [x] رفتن به مدرسه
- [ ] خرید لامپ
- [x] شستن دست ها

استفاده از تودو ها واقعا جالبه.

---

• نقل قول

فکر کنید میخواهید همچین نقل قولی را قرار دهید:

I'm gonna make him an offer he can't refuse.

ساختار به این صورت میباشد.

> I'm gonna make him an offer he can't refuse

• جداول

جدول ها در md خیلی راحت میباشد!

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

| Name | Last Name | Age |

| Name | Last Name | Age |

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

| Name | Last Name | Age |
| :---: | :---: | :---: |

Name	Last Name	Age

اما ولی چطوری یه ردیف بهش اضافه کنیم؟

| Name | Last Name | Age |
| :---: | :---: | :---: |
| Amir | Mohammadi | 17 |

Name	Last Name	Age
Amir	Mohammadi	17

ما تا الان ساخت جدول، وسط چیت کردن رو یاد گرفتیم. حتی اضافه کردن ردیف هم یاد گرفتیم. اما ولی چطوری برای مثال یه ستون رو چپ چین کنیم و یکی وسط چین؟

| Name | Last Name | Age |
| ---: | :---: | :--- |
| Amir | Mohammadi | 17 |

Name	Last Name	Age
Amir	Mohammadi	17

پس، -: برای چپ چین کردن و از دیگری یعنی :- برای راست چین کردن استفاده میشه.

دقت کنید دلیلی نداره که حتما باید جدول زیر هم باشه توی نوشتار. به هر ترتیبی که نوشته شود یک چیز اجرا میشود.

برای مثال:

| Name | Last Name | Age |
| :---: | :---: | :---: |
| Amir | Mohammadi | 17 |
| Ali | Hosseini | 20 |
| Omid | Zangeneg | 16 |
| Mohammadi | Fardi | 30 |

Name	Last Name	Age
Amir	Mohammadi	17
Ali	Hosseini	20
Omid	Zangeneg	16
Mohammadi	Fardi	30

اگر هم میخواهید که هیچ الاین یا همون align نداشته باشه جدول، از --- استفاده کنید.