GitHub'dan bir proje indirdiyseniz, npm ile yazılım kurduyseniz veya herhangi bir geliştirici aracıyla çalıştıysanız, README.md adlı bir dosyayla kesinlikle karşılaşmışsınızdır. Peki .md dosyası tam olarak nedir — ve neden okumak için üzerine çift tıklayamazsınız?

.md Dosyası Nedir?

Bir .md dosyası (Markdown'ın kısaltması), biçimlendirmeyi tanımlamak için basit bir sözdizimi kullanan düz metin dosyasıdır. .md uzantısı, içindeki metnin Markdown kurallarını izlediğini belirtir.

Bir Markdown dosyası işlendiğinde, bu kurallar görsel biçimlendirme üretir:

Markdown'ı Kim Yarattı?

John Gruber, 2004 yılında Aaron Swartz'ın önemli katkılarıyla Markdown'ı yarattı. Amaç, düz metin olarak okunabilir ancak temiz HTML'ye de dönüştürülebilen bir format oluşturmaktı.

MD Dosyaları Nerede Kullanılır?

Markdown, birçok bağlamda standart metin formatı haline gelmiştir:

• GitHub — README.md, CONTRIBUTING.md, issue şablonları, wikiler
• Dokümantasyon — Docusaurus, MkDocs, GitBook, Notion dışa aktarımları
• Statik site oluşturucular — Jekyll, Hugo, Gatsby, Nuxt Content
• Not alma — Obsidian, Notion, Bear, Typora
• Sohbet platformları — Slack ve Discord mesajlarda Markdown biçimlendirmesini destekler
• Akademik yazım — R Markdown, Pandoc, Jupyter Notebooks

Bir .md Dosyasını Nasıl Açarsınız?

İşletim sisteminiz varsayılan olarak Markdown'ı nasıl işleyeceğini bilmez:

• Windows, .md dosyalarını Notepad'de açar — ham metin görürsünüz
• Mac onları TextEdit'te açar — yine ham metin

Bir Markdown dosyasını amaçlandığı şekilde okumak için onu işleyen bir araca ihtiyacınız var:

1. Online — MDViewer.org: dosyanızı sürükleyin, anında okuyun
2. VS Code — dosyayı açın, Ctrl+Shift+V (Windows) veya Cmd+Shift+V (Mac) tuşuna basın
3. GitHub — dosyayı yükleyin; GitHub otomatik olarak işler
4. Özel uygulamalar — Typora, Obsidian, Zettlr

Geliştiriciler Neden Markdown Kullanır?

Markdown, geliştirici araçlarında çeşitli nedenlerle kazanmıştır:

1. Taşınabilir — Düz metin her yerde çalışır. Git onu fark edebilir. E-posta gönderebilir. Her editör açabilir.

2. Ham olarak okunabilir — İşleme olmadan bile ## Giriş açıkça bir başlıktır. Bu HTML veya Word belgeleri için geçerli değildir.

3. Hızlı yazım — Biçimlendirme için menü tıklamalarına gerek yok. **kelime** yazın ve devam edin.

4. Sürüm kontrolü yapılabilir — Metin olduğundan, Markdown dosyaları Git ile mükemmel çalışır.

5. Her şeye dönüştürülebilir — Pandoc gibi araçlarla Markdown, PDF, Word, LaTeX, HTML ve daha fazlasına dönüştürülür.

Markdown Sözdizimi Referansı

# Başlık 1
## Başlık 2
### Başlık 3

**kalın metin**
*italik metin*
~~üstü çizili~~

- Sırasız liste öğesi
1. Sıralı liste öğesi

[Bağlantı metni](https://example.com)
![Resim açıklaması](resim.png)

`satır içi kod`

```python
print("Merhaba, dünya!")

Alıntı bloğu

## .md ve .mdx Arasındaki Fark Nedir?

**MDX** (`.mdx`), Markdown dosyalarının içine JSX bileşenleri yerleştirmeye izin veren bir Markdown uzantısıdır. Nextra ve Docusaurus v3 gibi React tabanlı dokümantasyon çerçevelerinde kullanılır. Standart yazım ve dokümantasyon için, normal `.md` dosyaları neredeyse her zaman yeterlidir.

## Sık Sorulan Sorular

### Kendi .md dosyamı oluşturabilir miyim?

Evet — herhangi bir metin editörünü açın, Markdown içeriği yazın ve `.md` uzantısıyla kaydedin.

### Markdown her platformda aynı mı?

Temel Markdown sözdizimi standarttır, ancak birçok platform uzantılar ekler — GitHub Flavored Markdown (GFM) tablolar, görev listeleri ve üstü çizili metin ekler.

### Bir .md dosyası ne kadar büyük olabilir?

Pratik bir boyut sınırı yoktur. Büyük dosyalar sorunsuz çalışır. Performans görüntüleyici araca bağlıdır, formata değil.

---

Markdown dosyaları, şimdiye kadar oluşturulmuş en pratik düz metin formatlarından biridir. `.md` dosyalarıyla düzenli olarak karşılaşıyorsanız, [MDViewer.org](https://mdviewer.org) gibi bir **online MD görüntüleyici**, hiçbir şey yüklemeden onları okumanın en hızlı yoludur.