Formatlash vositalari

Tilni o'zgartirish

Menyu

Markdown nima?

Matnni yozish va formatlash usulini inqilob qilgan yengil markerlash tili. Nima uchun millionlab dasturchilar, yozuvchilar va kontent yaratuvchilari kundalik ishlarida Markdownni tanlashini bilib oling.

Markdown Tarixi

Markdown 2004-yilda John Gruber tomonidan Aaron Swartz bilan hamkorlikda yaratilgan. Maqsad oddiy, ammo inqilobiy edi: o'qish oson, yozish oson bo'lgan oddiy matn formatidan foydalanib yozish usulini yaratish, u tizimli jihatdan to'g'ridan to'g'ri HTML'ga aylantirilishi mumkin.

"Markdown" nomi "markup" so'zi bilan bog'liq bo'lib, u matnni xom shaklida ham o'qiladigan tarzda formatlashni belgilash imkonini berishiga ishora qiladi. HTML yoki boshqa markup tillaridan farqli o'laroq, Markdown inson tomonidan o'qilishi mumkinligiga ustuvorlik beradi.

Bugungi kunda Markdown butun veb bo'ylab hujjatlashtirish, README fayllari, forum muhokamalari va kontent yaratish uchun de-fakto standartiga aylandi. GitHub'dan Reddit'gacha, texnik hujjatlardan shaxsiy bloglargacha, Markdown hamma joyda matn formatlashni ta'minlaydi.

Yillar Bo'yicha

2004

John Gruber Markdownni yaratadi

O'qish oson, yozish oson bo'lgan oddiy matn formatidan foydalanib yozish usuli sifatida ishlab chiqilgan

2008

GitHub Markdownni qabul qiladi

GitHub README fayllari va hujjatlashtirish uchun Markdown'dan foydalanishni boshlaydi

2012

CommonMark spetsifikatsiyasi

Markdown sintaksisini standartlashtirishga qaratilgan harakat boshlanadi

2014

GitHub Flavored Markdown

GitHub Markdownning o'zining kengaytirilgan versiyasini chiqaradi

Hozir

Ommaviy qabul qilish

Butun dunyo bo'ylab millionlab dasturchilar, yozuvchilar va kontent yaratuvchilari tomonidan qo'llaniladi

Nima uchun Markdown tanlanadi?

Juda Tez

An'anaviy matn protsessorlariga qaraganda tezroq formatlangan kontent yozish

Kontentga E'tibor

Minimal sintaksis sizni yozayotgan narsangizga e'tiborni qaratishga yordam beradi

Umumiy Qo'llab-quvvatlash

Minglab ilovalar va platformalar tomonidan qo'llab-quvvatlanadi

Kelajakda Ham Amaliy

Oddiy matn formati uzoq umr va foydalanish imkoniyatini ta'minlaydi

Versiya Boshqaruvi

Git va boshqa versiyani boshqarish tizimlari bilan mukammal ishlaydi

O'rganish Oson

Bir necha daqiqada o'zlashtirish mumkin bo'lgan oddiy sintaksis

Markdown Qayerda Yorqin Ko'rinadi

Hujjatlashtirish

README fayllari, API hujjatlari va texnik hujjatlashtirish uchun mukammal

  • GitHub README fayllari
  • API hujjatlari
  • Loyihalar vikilari
  • Foydalanuvchi qo'llanmalari

Hamkorlik

Jamoaviy aloqa va bilimlarni almashish uchun ideal

  • Jamoaviy eslatmalar
  • Uchrashuv bayonnomalari
  • Loyihaviy takliflar
  • Kod tekshiruvlari

Veb Kontent

Bloglar, veb-saytlar va kontentni boshqarish uchun ajoyib

  • Blog postlari
  • Statik sayt generatorlari
  • CMS kontenti
  • Elektron pochta shablonlari

Shaxsiy Foydalanish

Shaxsiy eslatmalar va tashkil etish uchun juda yaxshi

  • Shaxsiy eslatmalar
  • Qilinadigan ishlar ro'yxatlari
  • Kundalik yozuvlar
  • O'quv materiallari

Sintaksisni O'zlashtirish

Darhol foydalanishingiz mumkin bo'lgan amaliy misollar bilan muhim Markdown sintaksisini o'rganing.

Sarlavhalar

# belgilari yordamida sarlavhalar yarating

# Sarlavha 1
## Sarlavha 2
### Sarlavha 3
#### Sarlavha 4
##### Sarlavha 5
###### Sarlavha 6

Matn Formatlash

Matnni turli uslublar bilan formatlash

**Qalin matn**
*Kursiv matn*
***Qalin va kursiv***
~~O'chirilgan matn~~
`Qator ichidagi kod`

Havolalar va Manbalar

Qator ichidagi yoki manba uslubida bosish mumkin bo'lgan havolalar yaratish

[Qator ichidagi havola](https://example.com)
[Sarlavhali havola](https://example.com "Sarlavha")
[Manba havola][1]

[1]: https://example.com "Manba sarlavhasi"

Ro'yxatlar va Vazifalar

Tartiblangan, tartiblanmagan va ichki joylashgan vazifalar ro'yxatlarini yaratish

- Tartiblanmagan element 1
- Tartiblanmagan element 2
  - Ichki element

1. Tartiblangan element 1
2. Tartiblangan element 2

- [x] Tugallangan vazifa
- [ ] Tugallanmagan vazifa

Rasmlar va Media

Alt matn va qo'shimcha sarlavhalar bilan rasmlarni joylash

![Alt matn](image.jpg)
![Alt matn](image.jpg "Rasm sarlavhasi")

[![Rasm havola](thumb.jpg)](full-image.jpg)

Kod Bloklari

Kodni qator ichida yoki sintaksisi ajratilgan bloklarda ko'rsatish

`qator ichidagi kod`

```javascript
function greet(name) {
  console.log(`Salom, ${name}!`);
}

greet("Dunyo");
```

```python
def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)
```

Iqtiboslar va Manbalar

Urg'u va manbalar uchun blok-iqtiboslar yaratish

> Bu oddiy blok-iqtibos
> 
> Bir nechta xatboshi qo'llab-quvvatlanadi
> 
> > Ichki blok-iqtiboslar ham ishlaydi

> **Eslatma:** Iqtiboslar ichida *formatlashni* ishlatishingiz mumkin

Jadvallar va Ma'lumotlar

Tekislash opsiyalari bilan tizimli jadvallar yaratish

| Xususiyat | Markdown | HTML |
|-----------|----------|------|
| Oddiy     | ✅      | ❌   |
| O'qishli  | ✅      | ❌   |
| Kuchli    | ✅      | ✅   |

| Chap | Markaz | O'ng |
|:-----|:------:|-----:|
| C1   |   M1   |   O1 |
| C2   |   M2   |   O2 |

Eng Yaxshi Amaliyotlar va Maslahatlar

✅ Buni qiling

  • • Bir xil oraliq va chekinishdan foydalaning
  • • Sarlavhalar va xatboshilar atrofida bo'sh qatorlar qo'shing
  • • Rasmlar uchun tavsiflovchi alt matnidan foydalaning
  • • Iloji bo'lsa, qatorlarni 80 belgidan kam tuting
  • • Toza matn uchun manba uslubidagi havolalardan foydalaning
  • • Nashr qilishdan oldin kontentingizni ko'rib chiqing

❌ Bundan saqlaning

  • • HTML'ni keraksiz aralashtirmang
  • • Nomuvofiq sarlavha darajalaridan saqlaning
  • • Rasmlar uchun alt matnini unutmaslikka harakat qiling
  • • Haddan tashqari murakkab jadval tuzilmalaridan saqlaning
  • • Juda ko'p ichki ro'yxatlardan foydalanmang
  • • Turli ro'yxat uslublarini aralashtirmang

Mashhur Markdown Vositalari

Platforma

GitHub

Kod omborlari va hujjatlashtirish

Muharrir

Typora

WYSIWYG markdown muharriri

Eslatmalar

Obsidian

Bilimlarni boshqarish va eslatma olish

Generator

Jekyll

Statik sayt generatori

Ish maydoni

Notion

Barchasi bitta ish maydoni

Aloqa

Discord

Chat va aloqa

Ijtimoiy

Reddit

Ijtimoiy yangiliklar va muhokama

Hujjatlashtirish

GitBook

Hujjatlashtirish platformasi

Generator

Hugo

Tez statik sayt generatori

Markdown Sayohatini Boshlashga Tayyormisiz?

Markdownning kuchi va soddaligini bo'yicha bilimlaringizni amalda qo'llash vaqti keldi. Muharririmizga qayting va o'zingizning Markdown hujjatingizni yarating!

Ctrl + BQalin
Ctrl + IKursiv
Ctrl + KHavola