Markdown, düz metni birkaç basit işaretle biçimlendirmenizi sağlayan hafif bir işaretleme dilidir. Başlık için # işareti, kalın yazı için iki yıldız, liste için tire kullanırsınız; yazdığınız metin hem ham hâliyle okunabilir kalır hem de HTML’e dönüştürülerek web sayfasında düzgün görünür. Bu rehberde Markdown nedir, nasıl kullanılır, temel söz dizimi nelerdir ve hangi editörlerle çalışılır, örneklerle anlatıyoruz.
Markdown Nedir?
Markdown, 2004 yılında John Gruber tarafından Aaron Swartz’ın katkılarıyla geliştirilen bir işaretleme dilidir. Amacı, HTML etiketleriyle uğraşmadan, e-posta yazar gibi doğal bir şekilde biçimlendirilmiş metin üretmektir. Markdown dosyaları genellikle .md uzantısıyla kaydedilir ve herhangi bir metin editörüyle açılabilir.
Markdown’un temel fikri şudur: Biçimlendirme işaretleri metnin okunabilirliğini bozmamalıdır. Örneğin bir kelimenin iki yanına yıldız koyduğunuzda, Markdown’u hiç bilmeyen biri bile o kelimenin vurgulandığını anlar. Dönüştürücü bir program ise bu işaretleri HTML’deki karşılıklarına çevirir.
Markdown’un Kısa Tarihçesi
- 2004: John Gruber, Markdown söz dizimini ve metni HTML’e çeviren ilk Perl betiğini yayımladı.
- Sonraki yıllar: Orijinal tanım bazı durumlarda belirsiz kaldığı için farklı platformlar kendi “lehçelerini” geliştirdi.
- CommonMark: Bu dağınıklığı gidermek için Markdown’un net ve test edilebilir bir tanımını sunan CommonMark standardı oluşturuldu.
- GitHub Flavored Markdown (GFM): GitHub, CommonMark üzerine tablo, görev listesi ve üstü çizili metin gibi eklemeler yapan kendi tanımını yayımladı.
Markdown Neden Bu Kadar Yaygın?
- Öğrenmesi kolay: Temel kuralları birkaç dakikada öğrenebilirsiniz.
- Okunabilir: Ham metin de düzenli görünür; dönüştürülmeden okunabilir.
- Taşınabilir: Düz metin dosyası olduğu için her işletim sisteminde ve editörde açılır, belirli bir programa bağımlı kalmazsınız.
- Sürüm kontrolüne uygun: Git gibi araçlarda değişiklikler satır satır izlenebilir. Bu yüzden yazılım dokümantasyonunun standart formatlarından biridir.
- Geniş destek: GitHub, GitLab, Stack Overflow, Reddit, Discord, Notion, Obsidian gibi birçok platform Markdown veya Markdown benzeri biçimlendirmeyi destekler.
- Yapay zekâ araçlarıyla uyumlu: ChatGPT, Claude ve Gemini gibi sohbet asistanları cevaplarını çoğunlukla Markdown ile biçimlendirir. Başlıklar, listeler ve kod blokları bu sayede düzenli görünür.
Markdown Nasıl Kullanılır? Temel Söz Dizimi
Aşağıdaki tablo, en sık kullanılan Markdown işaretlerini ve HTML karşılıklarını özetler:
| Öğe | Markdown yazımı | Sonuç |
|---|---|---|
| Başlık 1 | # Başlık | H1 başlık |
| Başlık 2 | ## Alt başlık | H2 başlık |
| Kalın | **metin** | metin |
| İtalik | *metin* | metin |
| Üstü çizili (GFM) | ~~metin~~ | Üstü çizili metin |
| Numarasız liste | – madde | Madde işaretli liste |
| Numaralı liste | 1. madde | Sıralı liste |
| Bağlantı | [metin](https://adres.com) | Tıklanabilir bağlantı |
| Görsel |  | Resim |
| Satır içi kod | `kod` | Kod biçiminde metin |
| Alıntı | > alıntı | Alıntı bloğu |
| Yatay çizgi | — | Ayırıcı çizgi |
Başlıklar
Başlıklar satır başına konan # işaretiyle oluşturulur. Bir # işareti H1, iki tane H2, altı tane H6 başlık anlamına gelir. İşaretten sonra bir boşluk bırakmayı unutmayın: # Başlık doğru, #Başlık bazı dönüştürücülerde başlık olarak algılanmaz. Belgede tek bir H1 kullanıp alt bölümleri H2 ve H3 ile kurmak, hem okunabilirlik hem de SEO açısından iyi bir alışkanlıktır.
Kalın, İtalik ve Üstü Çizili Metin
Kalın yazı için metni iki yıldız (**metin**) veya iki alt çizgi (__metin__) arasına alırsınız. İtalik için tek yıldız ya da tek alt çizgi yeterlidir. Kalın ve italiği birlikte kullanmak için üç yıldız (***metin***) yazılır. Üstü çizili metin (~~metin~~) orijinal Markdown’da yoktur, GitHub Flavored Markdown gibi lehçelerde desteklenir.
Listeler
Numarasız listeler için satır başına tire (-), yıldız (*) veya artı (+) koyabilirsiniz. Numaralı listeler için 1., 2. şeklinde yazmanız yeterlidir; çoğu dönüştürücü numaraları kendisi sıralar. Alt madde oluşturmak için satırı birkaç boşluk içeriden başlatırsınız.
GitHub gibi platformlarda görev listesi de oluşturabilirsiniz: – [ ] Yapılacak iş boş kutu, – [x] Tamamlanan iş işaretli kutu olarak görünür.
Bağlantılar ve Görseller
Bağlantı için köşeli parantez içine bağlantı metnini, hemen ardından normal parantez içine adresi yazarsınız: [Gezgin Ajans](https://gezginajans.com). Görsel eklemek de aynı yapıdadır, yalnızca başına ünlem işareti gelir: . Köşeli parantezdeki metin görselin alt metni olur; erişilebilirlik ve görsel SEO için bu alanı açıklayıcı yazın.
Kod Blokları
Satır içi kod için metni tek ters tırnak (`) arasına alırsınız. Birden fazla satırlık kod için üç ters tırnakla açıp üç ters tırnakla kapatırsınız. Açılıştaki ters tırnakların hemen arkasına dil adını yazarsanız (ör. “`python) destekleyen platformlar kodu renklendirir. Bu özellik API dokümantasyonlarında ve README dosyalarında sürekli kullanılır.
Alıntılar
Satır başına > işareti koyduğunuzda o satır alıntı bloğu olarak gösterilir. Başka bir kaynaktan yapılan alıntıları, notları veya uyarıları öne çıkarmak için kullanışlıdır. İç içe alıntı için >> yazabilirsiniz.
İleri Seviye Markdown Kullanımı
Tablo Oluşturma
Tablolar orijinal Markdown’da yoktur ama GFM ve birçok editör destekler. Sütunları dikey çizgi (|) ile ayırır, başlık satırının altına tirelerden oluşan bir ayırıcı satır eklersiniz:
| Ürün | Fiyat |
| — | —: |
| Kalem | 20 TL |
Ayırıcı satırdaki iki nokta üst üste işareti hizalamayı belirler: :— sola, :—: ortaya, —: sağa hizalar.
Kaçış Karakterleri
Markdown’da özel anlamı olan bir karakteri (yıldız, alt çizgi, diyez gibi) düz metin olarak göstermek istiyorsanız önüne ters eğik çizgi koyarsınız. Örneğin \* yazdığınızda yıldız italik başlatmaz, ekranda yıldız olarak görünür.
HTML ile Birlikte Kullanım
Markdown’un karşılamadığı durumlarda belgeye doğrudan HTML etiketleri yazabilirsiniz. Örneğin bir görselin boyutunu ayarlamak veya açılır kapanır bir bölüm eklemek için HTML kullanılabilir. Ancak bazı platformlar güvenlik nedeniyle belirli HTML etiketlerini kaldırır; yazdığınız kodun hedef platformda çalıştığını kontrol edin. HTML’in yapısını merak ediyorsanız HTML div nedir ve XHTML nedir yazılarımıza göz atabilirsiniz.
Markdown’un Kullanım Alanları
- Yazılım dokümantasyonu: GitHub ve GitLab projelerindeki README.md dosyaları, değişiklik kayıtları ve wiki sayfaları Markdown ile yazılır.
- API dokümantasyonu: Uç noktaların açıklamaları ve örnek kodlar düzenli şekilde sunulur. API kavramına yabancıysanız API nedir yazımızı okuyabilirsiniz.
- Blog ve web içeriği: Hugo, Jekyll gibi statik site oluşturucular ve Ghost gibi CMS’ler içerikleri Markdown ile yönetebilir. WordPress blok editörü de yapıştırılan Markdown metnini büyük ölçüde bloklara dönüştürür.
- Not alma: Obsidian gibi uygulamalar notları Markdown dosyaları olarak saklar; notlarınız tek bir uygulamaya kilitlenmez.
- Yapay zekâ ile çalışma: Sohbet asistanlarına Markdown biçiminde düzenli talimat vermek veya cevapları Markdown olarak almak, metni başka araçlara aktarmayı kolaylaştırır. İçerik üretiminde yapay zekâdan faydalanmak için içerik üretimi için etkili ChatGPT promptları yazımıza bakabilirsiniz.
- Mesajlaşma ve forumlar: Discord, Reddit ve Stack Overflow gibi platformlarda metin biçimlendirmek için Markdown kullanılır.
Markdown Editörleri ve Araçları
Markdown herhangi bir metin editöründe yazılabilir, ancak önizleme ve kısayol sunan araçlar işi kolaylaştırır:
- Visual Studio Code: Ücretsizdir, Markdown dosyalarını yan panelde canlı önizlemeyle gösterir ve eklentilerle genişletilebilir. Tarayıcıda çalışan VS Code for the Web sürümü de vardır.
- Typora: Yazdığınız işaretleri anında biçimlendirilmiş hâle getiren, sade arayüzlü ücretli bir editördür.
- Obsidian: Markdown dosyaları üzerine kurulu, notlar arası bağlantı kurmayı kolaylaştıran bir not uygulamasıdır.
- StackEdit ve Dillinger: Kurulum gerektirmeden tarayıcıda Markdown yazmanızı ve önizlemenizi sağlayan çevrim içi araçlardır.
- Pandoc: Markdown dosyalarını HTML, Word, PDF gibi formatlara dönüştüren komut satırı aracıdır.
Eskiden sık önerilen Atom editörü 2022 sonunda geliştirilmesi durdurularak arşivlendi; yeni başlayacaksanız yukarıdaki güncel araçları tercih edin.
Markdown ve Diğer İşaretleme Dilleri
| Dil | Öne çıkan özellik | Tipik kullanım |
|---|---|---|
| Markdown | Basit, okunabilir söz dizimi | README, blog, not, dokümantasyon |
| HTML | Web sayfalarının tam yapısı | Web sayfası ve uygulama arayüzü |
| reStructuredText | Daha zengin dokümantasyon özellikleri | Python projeleri, Sphinx dokümantasyonu |
| AsciiDoc | Kitap ve teknik kılavuz odaklı | Uzun teknik dokümanlar |
| Textile | Markdown’a benzer, daha az yaygın | Bazı eski CMS ve proje yönetim araçları |
Markdown bir işaretleme dilidir; verileri yapılandırmak için kullanılan formatlar ise farklı amaçlara hizmet eder. Bu farkı görmek için JSON nedir ve XML nedir yazılarımızı inceleyebilirsiniz. Görsel düzenleyicilerle Markdown arasındaki farkı ise WYSIWYG nedir yazımızda bulabilirsiniz.
Markdown Kullanırken Sık Yapılan Hatalar
- # işaretinden sonra boşluk bırakmamak: Başlık düz metin olarak görünebilir.
- Paragraflar arasında boş satır bırakmamak: Ardışık satırlar tek paragraf olarak birleşir.
- Lehçe farkını unutmak: Tablo veya görev listesi bir platformda çalışırken diğerinde çalışmayabilir.
- Liste girintilerini karıştırmak: Alt maddeler yanlış girintilenirse liste yapısı bozulur.
- Alt metni boş bırakmak: Görsellerin erişilebilirliği ve arama motorlarında anlaşılması zayıflar.
Web Sitenizde İçerik Yönetimi
Markdown, içerik ekipleri ile geliştiriciler arasında ortak bir dil sunar; metinler hızlı hazırlanır, düzenli kalır ve farklı sistemlere kolayca aktarılır. Gezgin Ajans olarak kurumsal web tasarım projelerimizde içerik yapısını ekibinizin kolayca yönetebileceği şekilde kuruyor, WordPress tabanlı siteler için WordPress destek hizmeti veriyoruz.
Sıkça Sorulan Sorular
Markdown öğrenmek zor mu?
Hayır. Başlık, kalın, italik, liste ve bağlantı gibi temel işaretleri kısa sürede öğrenebilirsiniz. Günlük kullanımın büyük kısmı bu birkaç kuraldan oluşur.
Markdown dosyası (.md) nasıl açılır?
Not Defteri dahil her metin editörüyle açılabilir. Biçimlendirilmiş hâlini görmek için VS Code, Typora, Obsidian gibi önizleme sunan bir editör veya GitHub gibi Markdown’u işleyen bir platform kullanabilirsiniz.
Markdown ile HTML arasındaki fark nedir?
HTML web sayfalarının tüm yapısını tanımlayan ayrıntılı bir dildir. Markdown ise yazmayı kolaylaştırmak için geliştirilmiş, sonunda genellikle HTML’e dönüştürülen sade bir söz dizimidir. Markdown, HTML’in yalnızca sık kullanılan bölümlerini kapsar.
Markdown’da tablo nasıl yapılır?
Sütunları dikey çizgi (|) ile ayırır, başlık satırının altına tirelerden oluşan bir ayırıcı satır eklersiniz. Tablolar GitHub Flavored Markdown gibi lehçelerde desteklenir; orijinal Markdown tanımında yer almaz.
CommonMark nedir?
CommonMark, Markdown’un farklı uygulamalarda aynı sonucu vermesi için hazırlanmış ayrıntılı bir standarttır. GitHub Flavored Markdown da CommonMark üzerine kuruludur.


