Markdown nedir, .md dosyası nasıl okunur?

Bir yerden .md uzantılı bir dosya aldınız ya da elinizdeki metnin içinde yıldızlar, diyezler ve köşeli parantezler görüyorsunuz: **böyle**, # şöyle. İlk bakışta bozuk bir metin gibi durur; oysa bozuk değildir, biçimlendirilmiştir. Bu yazım biçiminin adı Markdown'dır.

Markdown'ın fikri şudur: metni biçimlendirmek için düğmelere basmak yerine, biçimi metnin içine birkaç işaretle yazarsınız. Yıldızın arasına aldığınız kelime kalın, diyezle başlayan satır başlık olur. İşaretleri okuyan bir program metni işlediğinde ortaya düzgün bir belge çıkar; işlemeyen bir program açtığında da metin okunur kalır, çünkü içinde gizli hiçbir şey yoktur.

.md dosyası nasıl açılır?

Markdown dosyası düz yazıdan ibarettir; yani herhangi bir yazı düzenleyici onu açabilir. Düzenleyiciyi çalıştırın, Dosya menüsünden Aç'ı seçin ve açılan pencerenin sağ alt köşesindeki tür kutusunu "Tüm dosyalar" yapın — bu kutu "Metin belgeleri" seçiliyken .md dosyanız listede hiç görünmez. Karşınıza dosyanın tamamı, işaretleriyle birlikte çıkar.

Dosyayı biçimlenmiş hâliyle görmek istiyorsanız iki yol vardır. Markdown'ı tanıyan bir uygulamada açabilirsiniz — birçok not uygulaması, kod düzenleyici ve depo sitesi metni açar açmaz işler. Ya da metni HTML'e çevirip tarayıcıda açabilirsiniz; bu ikincisi, belgeyi başkasına göndermeniz ya da bir sayfaya yerleştirmeniz gerektiğinde daha kullanışlıdır.

Uzantıyı hiç görmüyorsanız — dosya adının sonunda .md yazmıyorsa — Windows'ta Dosya Gezgini'nin Görünüm sekmesinden "Dosya adı uzantıları" kutusunu işaretleyin. Uzantıyı görmek, bir dosyanın hangi programla açılacağını anlamanın en kestirme yoludur.

En sık kullanılan işaretler

Markdown'ın tamamını öğrenmeniz gerekmez; günlük yazımın neredeyse hepsi aşağıdaki işaretlerle döner. Tabloyu bir kez gözden geçirmeniz, karşınıza çıkan her metni çözmenize yeter.

Bir noktaya dikkat edin: bu işaretlerin çoğu satırın en başında ve ardından bir boşlukla yazılır. Diyezle başlığın arasındaki boşluğu unutursanız satır başlığa dönüşmez, olduğu gibi kalır.

Markdown nerede karşınıza çıkar?

Markdown, yazının biçimini metnin içinde taşıdığı için biçim bilgisi hiçbir zaman kaybolmaz. Bu yüzden metnin elden ele dolaştığı yerlerde tercih edilir.

En çok görüldüğü yer yazılım depolarıdır: bir projenin tanıtım dosyası olan README hemen her zaman Markdown'dır. Bunun dışında not uygulamaları, ekip içi wiki sayfaları, forumlar, sohbet uygulamaları ve blog üreten sistemler aynı yazımı kullanır. Yapay zekâ sohbetlerinden kopyaladığınız metinlerde gördüğünüz yıldızlar da budur.

Word gibi bir kelime işlemciye göre farkı şudur: Word belgesinde biçim, belgenin görünmeyen bir yerinde saklanır ve dosyayı açacak programın o biçimi anlaması gerekir. Markdown'da biçim gözünüzün önündedir. Bunun bedeli, karmaşık düzenlerin (çok sütunlu sayfa, dipnot, sayfa numarası) Markdown'da bulunmamasıdır; Markdown kısa ve düz belgeler için tasarlanmıştır.

Metni HTML'e çevirmek

Markdown metnini bir web sayfasına, bir içerik yönetim sistemine ya da e-posta gövdesine koyacaksanız araya bir çeviri adımı girer: HTML. Markdown'dan HTML'e aracına metni yapıştırdığınızda başlıklar, listeler ve bağlantılar karşılık gelen etiketlere dönüşür.

İki çıktı biçimi arasından seçim yaparsınız. Gövde çıktısı yalnızca içerik etiketlerini verir; var olan bir şablonun içine yapıştırmak için doğru olan budur. Tam sayfa çıktısı ise tarayıcıda doğrudan açılabilen çalışır bir dosya üretir.

Aracın kapsamı günlük yazımın çekirdeğiyle sınırlıdır: başlık, kalın, italik, liste, alıntı, bağlantı ve kod. Tablo, görsel ve iç içe liste bu kapsamın dışındadır ve düz metin olarak çıkar — sessizce kaybolmaz. Böyle bir belgeniz varsa çıktıyı gözden geçirip o bölümleri elle tamamlayın.

Tablolar: standart ile lehçe farkı

Markdown'ın çekirdek tanımında tablo yoktur. Tablolar sonradan, bazı ortamların eklediği genişletmelerle geldi; bu yüzden aynı tablo yazımı bir yerde düzgün görünürken başka bir yerde satır satır düz metin olarak çıkabilir. Tablo yazmadan önce metni nerede yayımlayacağınıza bakın.

Tablo yazımı dikey çizgilerle sütun kurar ve başlığın hemen altına bir çizgi satırı ister. Elle yazmak birkaç satırdan sonra yorucu olur, hizalar da kolayca bozulur.

Elinizdeki veri zaten bir tablodaysa daha kısa bir yol var: veriyi CSV olarak kaydedip CSV'den Markdown Tablosuna aracına verin. Çıkan tabloyu doğrudan README'nize ya da wiki sayfanıza yapıştırabilirsiniz; hücreler sütun genişliğine göre hizalandığı için işlenmemiş hâliyle bile okunur kalır.

Sık yapılan dört hata

Markdown'ın işaretleri basit olduğu için hatalar da hep aynı birkaç yerde toplanır. Bir metin beklediğiniz gibi görünmüyorsa önce bunlara bakın.

• Unutulan boşluk: diyez ile başlık metni arasında, tire ile madde metni arasında bir boşluk olmalıdır. "#Başlık" başlık olmaz, "# Başlık" olur.
• Beklenmedik satır birleşmesi: alt alta yazdığınız iki satır çoğu ortamda tek paragraf sayılır. Ayrı paragraf istiyorsanız aralarına boş bir satır bırakın.
• Yıldız gerçekten yıldız olduğunda: fiyat listesi ya da dipnot işareti gibi metinde geçen bir yıldız yanlışlıkla biçimlendirme sanılabilir. Yıldızın önüne ters bölü koyarak (\*) olduğu gibi kalmasını sağlarsınız.
• Görsel ile bağlantıyı karıştırmak: köşeli parantezle başlayan yazım bağlantıdır, önüne ünlem konursa görseldir. Ünlemi unutan bir satır, resmi göstermek yerine adresine giden bir bağlantı üretir.

Sık sorulanlar

Markdown nedir, ne işe yarar?

Metnin biçimini metnin kendi içinde birkaç işaretle anlatan sade bir yazım biçimidir. Yıldız arasına alınan kelime kalın, diyezle başlayan satır başlık olur. Dosya sade metin olduğu için her yerde açılır ve biçim bilgisi kaybolmaz.

.md dosyası nasıl açılır?

Yazı düzenleyicide Dosya menüsünden Aç'ı seçip tür kutusunu "Tüm dosyalar" yapmanız yeterlidir; dosya düz yazıdır. Biçimlenmiş hâlini görmek için Markdown'ı tanıyan bir uygulamada açabilir ya da metni HTML'e çevirip tarayıcıda görüntüleyebilirsiniz.

Markdown'ı HTML'e nasıl çeviririm?

Metni Markdown'dan HTML'e aracına yapıştırın; başlıklar, listeler ve bağlantılar etiketlere dönüşür. Var olan bir şablonun içine koyacaksanız gövde çıktısını, tek başına açılacak bir dosya istiyorsanız tam sayfa çıktısını seçin.

Markdown'da tablo yazabilir miyim?

Çekirdek tanımda tablo yoktur; tablolar bazı ortamların eklediği genişletmelerle gelir, bu yüzden her yerde aynı görünmez. Veriniz zaten tablo hâlindeyse CSV olarak kaydedip CSV'den Markdown Tablosuna aracıyla çevirmek en kısa yoldur.

Markdown ile Word arasındaki fark ne?

Word'de biçim belgenin görünmeyen bir yerinde saklanır; Markdown'da biçim metnin içinde, gözünüzün önündedir. Markdown daha taşınabilirdir ama çok sütunlu sayfa, dipnot ve sayfa numarası gibi karmaşık düzenleri desteklemez.

Son güncelleme: 27 Ağustos 2026