Markdown Yazma Bələdçisi: Mürəkkəb Proqram Olmadan Gözəl Sənədlər Formatlaşdırın

Markdown sadə, oxuna bilən sintaksis istifadə edərək mətni formatlaşdırmağa imkan verən yüngül işarələmə dilidir. 2004-cü ildə John Gruber tərəfindən yaradılıb və vebdə yazının de-fakto standartına çevrilib. GitHub README fayllar, sənədləşdirmə platformaları, statik sayt generatorları, qeyd tətbiqləri, forumlar və hətta e-poçt müştəriləri Markdown-ı dəstəkləyir. Sadə sintaksisini öyrəndikdən sonra ağır söz emalçılarına əl atmadan hər yerdə gözəl formatlanmış sənədlər yarada bilərsiniz.

Niyə Markdown?

**Oxunabilirlik.** HTML-dən fərqli olaraq teqlərin kontenti gizlətdiyi yerdə Markdown xam, formatlanmamış vəziyyətində belə oxuna bilən şəkildə hazırlanıb.

**Daşınabilirlik.** Markdown faylları düz mətn (.md və ya .markdown uzantısı). İstənilən əməliyyat sistemində istənilən mətn redaktorunda açılır. Mülkiyyət proqram bağlılığı yoxdur, uyğunluq problemləri yoxdur.

**Çoxtərəflilik.** Markdown HTML, PDF, Word sənədlərinə, slaydlara, e-kitablara və daha çoxuna çevrilir. Bir dəfə yazın, hər yerdə nəşr edin.

**Sürət.** Markdown-da formatlaşdırma alətlər panelində maus ilə düymələrə klikləməkdən daha sürətlidir. Əlləriniz heç vaxt klaviaturanı tərk etmir.

**Versiya nəzarəti ilə uyğunluq.** Markdown düz mətn olduğu üçün Git ilə mükəmməl işləyir. Dəyişiklikləri izləyə, versiyaları müqayisə edə, töhfələri birləşdirə və sənədlərinizin tam tarixçəsini saxlaya bilərsiniz.

Əsas Formatlışdırma

### Başlıqlar

Başlıqlar heş simvolları ilə yaradılır. Heşlərin sayı başlıq səviyyəsini göstərir:

`# Başlıq 1` ən böyük başlığı yaradır `## Başlıq 2` ikinci səviyyə başlıq yaradır `### Başlıq 3` üçüncü səviyyə başlıq yaradır

Altıya qədər dərin gedə bilərsiniz, amma əksəriyyət sənədlər nadir hallarda üç və ya dörddən artıq səviyyəyə ehtiyac duyur.

### Mətn Vurğusu

• `*kursiv*` və ya `_kursiv_` kursiv mətn verir
• `**qalın**` və ya `__qalın__` qalın mətn verir
• `***qalın kursiv***` hər ikisini birləşdirir
• `~~üzəri xətli~~` üzəri xətli mətn verir

### Paraqraflar və Sətir Keçidləri

Paraqraflar boş sətirlə ayrılır. Başqa Markdown rendererlərinin əksəriyyətində yalnız bir dəfə Enter basma yeni paraqraf yaratmır -- mətn blokları arasında boş sətir lazımdır.

Siyahılar

### Sırasız Siyahılar

`-`, `*` və ya `+` istifadə edib ardından boşluq gəlir:

``` - Birinci element - İkinci element - İç-içə element - Üçüncü element ```

### Sıralı Siyahılar

Rəqəmlərdən sonra nöqtə gəlir:

``` 1. Birinci addım 2. İkinci addım 3. Üçüncü addım ```

### Tapşırıq Siyahıları

GitHub-Flavored Markdown (GFM) çek qutularını dəstəkləyir:

``` - [x] Tamamlanmış tapşırıq - [ ] Tamamlanmamış tapşırıq ```

Linklər və Şəkillər

### Linklər

`[Link mətni](https://example.com)` klikləna bilən hiperlink yaradır.

### Şəkillər

`` şəkil yerləşdirir. Alt mətn əlçatanlıq üçün vacibdir.

Kod

### Sətirçi Kod

Kodu tək geriyə işarətlərlə sarın: `console.log("salam")` sətirçi kod kimi verir.

### Kod Blokları

Sintaksis vurğulaması üçün istəyə bağlı dil identifikatoru ilə üç geriyə işarət istifadə edin.

Cədvəllər

Markdown cədvəllər borular və tirələr istifadə edir:

``` | Xüsusiyyət | Pulsuz Plan | Pro Plan | |------------|-------------|----------| | Yaddaş | 5 GB | 100 GB | | İstifadəçilər | 1 | Limitsiz | ```

Sitat Blokları

Sitat blokları yaratmaq üçün `>` istifadə edin:

``` > Ağac əkmək üçün ən yaxşı vaxt iyirmi il əvvəl idi. > İkinci ən yaxşı vaxt indidir. ```

Təkmil Markdown

### Dipnotlar, Tərif Siyahıları, Riyazi Tənliklər

Bəzi Markdown emalçıları dipnotları, tərif siyahılarını və LaTeX riyaziyyatını dəstəkləyir.

Fərqli Platformalar üçün Markdown

### GitHub-Flavored Markdown (GFM)

GitHub standart Markdown-ı tapşırıq siyahıları, cədvəllər, üzəri xətli mətn, avtomatik linklənmiş URL-lər və sintaksislə vurğulanmış kod blokları ilə genişləndirir.

### Sənədləşdirmə Platformaları

Docusaurus, MkDocs və GitBook kimi alətlər əsas kontent formatı kimi Markdown istifadə edir.

### Statik Sayt Generatorları

Next.js, Hugo, Jekyll və Astro hamısı kontent üçün Markdown-ı dəstəkləyir.

Yazma İş Axını Məsləhətləri

1. **Markdown önizləmə alətindən istifadə edin.** Vaxtım Yoxdu-dakı Markdown Önizləmə yazdığınız kimi real vaxtda formatlanmış nəticənizi göstərir.
2. **Sözlərinizi sayın.** Uzunluq tələbləri olan kontent üçün Vaxtım Yoxdu-dakı Söz Sayacı sözləri, simvolları, cümlələri və paraqrafları izləyir.
3. **URL-dostu sluglar yaradın.** Bloq üçün başlıqlardan təmiz, SEO-dostu URL-lər yaradan Slug Generatoru istifadə edin.
4. **Versiyaları müqayisə edin.** Markdown sənədlərindəki dəyişiklikləri yoxlayanda Mətn Fərqi aləti dəqiq nəyin dəyişdiyini sətir-sətir vurğulayır.
5. **Diqqəti dağıdıcı olmayan redaktorda yazın.** Minimal mətn redaktoru və ya xüsusi Markdown redaktoru istifadə edin.
6. **Konvensiyaları erkən müəyyən edin.** Komanda layihələri üçün formatlaşdırma konvensiyalarını qabaqcadan qərarlaşdırın.

Markdown öyrənməsi həqiqətən sadə və dərhal faydalı olan nadir texnologiyalardan biridir. 15 dəqiqədə əsasları mənimsəyə bilərsiniz. Bir saatda təkmil formatlaşdırma edə bilərsiniz. Və bundan sonra hər yerdə işləyən daşına bilən, versiya-nəzarətli, gələcəyə-davamlı yazma formatınız var. Vaxtım Yoxdu-dakı Markdown Önizləmə aləti ilə məşq edin.