Markdown ile İçerik Üretimi: Blog, Rehber ve SEO

Markdown, içerik üretimi için güçlüdür çünkü yazı, yapı ve metadata aynı dosyada durabilir. Bu da blog, rehber, dokümantasyon ve içerik pipeline'ı için sade bir üretim akışı sağlar.

Bu rehber CBS tarzı içerik üretimine odaklanır: ADHD, PKM, araçlar, sözlük ve rehber içeriklerini hızlı ama temiz yayınlamak.

1. Markdown İçerik Üretiminde Neyi Kolaylaştırır?

Markdown içerik üretiminde dört işi kolaylaştırır:

1. Taslak yazmak.
2. Yazıyı bölümlere ayırmak.
3. Metadata eklemek.
4. Yayına hazır dosya üretmek.

Bir Markdown blog dosyası sadece metin değildir. Aynı zamanda yayın sisteminin okuyabileceği yapılandırılmış veridir.

2. İçerik Dosyasının Temel Yapısı

Tipik bir rehber dosyası:

---
title: "Markdown ile İçerik Üretimi"
subtitle: "Blog, rehber ve SEO için Markdown akışı."
date: "2026-05-07"
readTime: "24 dk okuma"
author: "Chaotic Brain Studio"
tag: "Sistemler ve Araçlar"
excerpt: "Markdown ile içerik üretim sistemi kurma rehberi."
---

Giriş paragrafı.

## 1. Ana Bölüm

İçerik.

## 2. Ana Bölüm

İçerik.

## Sonraki Adım

Okuyucunun yapacağı küçük aksiyon.

Bu yapı hem insan hem sistem tarafından okunabilir.

3. İyi Bir Rehberin İskeleti

CBS rehberleri için pratik iskelet:

## Problem

## Neden Olur?

## Temel Mantık

## Adım Adım Uygulama

## Örnek

## Sık Yapılan Hatalar

## Minimum Başlangıç

## Sonraki Adım

Her rehber bu sırayı birebir takip etmek zorunda değil. Ama bu yapı özellikle öğretici içerikler için güvenli bir başlangıçtır.

4. Başlık Hiyerarşisi ve SEO

Başlıklar sadece görsel ayrım değildir. Arama motorları ve okuyucular yazının yapısını başlıklardan anlar.

İyi yapı:

# Markdown ile İçerik Üretimi

## Markdown İçerik Üretiminde Neyi Kolaylaştırır?

## İçerik Dosyasının Temel Yapısı

## SEO İçin Markdown Başlıkları

### H2 ve H3 Nasıl Kullanılmalı?

Zayıf yapı:

## Giriş
#### SEO
# Başlıklar
### Sonuç

Kural:

• H1 sayfa başlığıdır.
• H2 ana bölümdür.
• H3 alt bölümdür.
• H4 nadiren gerekir.

5. Frontmatter ile Yayın Kontrolü

Frontmatter, içeriğin yayın sistemine söylediği şeydir.

Örnek:

---
title: "Markdown ile İçerik Üretimi"
subtitle: "Blog, rehber ve SEO için Markdown akışı."
date: "2026-05-07"
dateModified: "2026-05-07"
readTime: "24 dk okuma"
author: "Chaotic Brain Studio"
tag: "Sistemler ve Araçlar"
series: "markdown-rehberi"
seriesTitle: "Markdown Rehberi"
seriesOrder: 4
tool: "markdown"
excerpt: "Markdown ile blog ve rehber üretmek için kapsamlı yayın rehberi."
---

Frontmatter sayesinde:

• sayfa başlığı belirlenir,
• SEO açıklaması oluşturulur,
• rehber serisi gruplanır,
• kategori etiketi görünür,
• ilgili yazılar bağlanır,
• sitemap ve metadata üretilebilir.

6. Excerpt Nasıl Yazılır?

Excerpt, yazının kısa açıklamasıdır.

İyi excerpt:

Markdown ile blog ve rehber üretmek için başlık hiyerarşisi, frontmatter, internal link, SEO, taslak akışı ve yayın kontrol listesi.

Zayıf excerpt:

Markdown hakkında yazı.

Excerpt şunları söylemeli:

• konu ne,
• kim için,
• ne öğretecek,
• hangi problemi çözecek.

7. TLDR Nasıl Yazılır?

TLDR, hızlı okuyucu için 3 maddelik özettir.

İyi TLDR:

tldr:
  - "Markdown, içerik üretiminde taslak, yapı ve metadata'yı aynı dosyada tutmayı kolaylaştırır."
  - "SEO için başlık hiyerarşisi, açıklayıcı link metni ve net bölüm yapısı önemlidir."
  - "Yayın akışı fikirden taslağa, taslaktan rehbere, rehberden kontrol listesine ilerler."

Kural:

• 3 madde yeterlidir.
• Her madde farklı değer taşısın.
• Aynı cümleyi üç kez tekrar etme.

8. İç Link Stratejisi

Markdown içerikte iç link çok değerlidir.

İyi iç link:

Markdown dosyalarını düzenlemek için [Markdown dosya mimarisi rehberine](/rehberler/markdown-dosya-mimarisi-frontmatter-metadata) geçebilirsin.

Zayıf iç link:

Daha fazlası için [tıkla](/rehberler/markdown-dosya-mimarisi-frontmatter-metadata).

İç linkler:

• kullanıcıyı bir sonraki mantıklı adıma taşır,
• site içi bilgi ağını güçlendirir,
• arama motorlarına konu ilişkisini gösterir.

9. Markdown ile AEO Uyumlu İçerik

AEO, Answer Engine Optimization demektir. Yani içeriğin cevap motorları tarafından kolay anlaşılması.

Markdown burada avantajlıdır çünkü yapı nettir.

AEO dostu blok:

## Markdown nedir?

Markdown, düz metni basit işaretlerle başlık, liste, link, tablo ve kod bloğu gibi yapılara dönüştüren hafif bir işaretleme dilidir.

İyi AEO içeriği:

• soruyu başlıkta sorar,
• cevabı ilk paragrafta net verir,
• sonra detaylandırır,
• örnek ekler,
• ilişkili kavrama link verir.

10. Blog Yazısı İçin Markdown Akışı

Bir blog yazısını Markdown ile üretmek için şu akış kullanılabilir:

Fikir
→ Brain dump
→ Başlık seçenekleri
→ Bölüm iskeleti
→ İlk taslak
→ İç linkler
→ Frontmatter
→ Yayın kontrolü

Adım 1: Brain Dump

# Markdown içerik üretimi brain dump

- Frontmatter önemli
- SEO için başlık hiyerarşisi
- İç linkler
- TLDR
- Yayın checklist
- Markdown blog için hızlı

Adım 2: Bölüm İskeleti

## Markdown İçerik Üretiminde Neyi Kolaylaştırır?
## İçerik Dosyasının Temel Yapısı
## SEO İçin Başlık Hiyerarşisi
## Frontmatter
## İç Link Stratejisi
## Yayın Kontrol Listesi

Adım 3: İlk Taslak

İlk taslak kötü olabilir. Bu normaldir. Markdown'ın avantajı taslağı hızlı çıkarabilmektir.

Adım 4: Yapı Temizliği

Başlıklar doğru sırada mı? Liste maddeleri tutarlı mı? Linkler açıklayıcı mı?

Adım 5: Yayın Kontrolü

Son checklist'e geç.

11. Rehber İçin Markdown Akışı

Rehber blogdan daha kapsamlıdır. Rehberde okuyucu adım adım ilerlemek ister.

Rehber iskeleti:

## Kimler İçin?

## Ne Öğreneceksin?

## Temel Kavramlar

## Kurulum

## Adım Adım Uygulama

## Örnek Senaryo

## Sık Yapılan Hatalar

## Kontrol Listesi

## Sonraki Bölüm

Uzun rehberde her bölüm kendi küçük vaadini taşımalı.

12. Seri İçeriği Nasıl Kurulur?

Markdown yazı dizisi için her dosyada aynı series ve seriesTitle kullanılır.

series: "markdown-rehberi"
seriesTitle: "Markdown Rehberi"
seriesOrder: 4

Bu sayede site rehberleri sıraya koyabilir.

Seri mantığı:

13. Markdown Yayın Checklist

## Yayın Öncesi Kontrol

- [ ] Başlık net mi?
- [ ] Excerpt yazının vaadini anlatıyor mu?
- [ ] TLDR 3 güçlü madde mi?
- [ ] H2 başlıklar mantıklı sırada mı?
- [ ] H3 başlıklar doğru bölüm altında mı?
- [ ] İç linkler açıklayıcı mı?
- [ ] Kod bloklarında dil belirtildi mi?
- [ ] Tablolar mobilde gereksiz uzun mu?
- [ ] Sonraki adım var mı?
- [ ] Frontmatter geçerli mi?

14. Sık Yapılan İçerik Hataları

Hata 1: Yazıya Başlıksız Başlamak

Uzun metin başlıksız olursa okuyucu kaybolur.

Hata 2: SEO İçin Anahtar Kelime Doldurmak

Markdown rehberi Markdown rehberi Markdown rehberi gibi tekrarlar kaliteyi düşürür. Konuyu doğal anlat.

Hata 3: Her Şeyi Tek Yazıya Koymak

Konu büyüyorsa seri yap. Bu rehber dizisi bunun örneği.

Hata 4: İç Linkleri Sonradan Unutmak

İç linkler yazının parçasıdır. Yayın kontrolünde ayrıca kontrol edilmeli.

Hata 5: Frontmatter'ı Kopyalayıp Güncellememek

Yanlış tarih, yanlış seri sırası veya yanlış excerpt site davranışını bozabilir.

15. CBS İçerik Pipeline Örneği

Obsidian notu
→ Markdown taslak
→ Rehber iskeleti
→ MDX dosyası
→ Build
→ Vercel deploy
→ Sözlük ve ilgili rehber linkleri

Bu akışta Markdown hem yazı formatı hem üretim köprüsüdür.

16. Minimum Uygulama

Bugün tek bir Markdown içerik dosyası oluştur:

---
title: "İlk Markdown Rehberim"
excerpt: "Markdown ile rehber yazma denemesi."
---

## Problem

## Çözüm

## Adımlar

## Kontrol Listesi

## Sonraki Adım

Bu iskeleti doldur. Mükemmel yapma. Önce çalışan taslak üret.

17. Sonraki Adım

Bir sonraki bölümde Markdown dosya mimarisini kuracağız: klasör yapısı, isimlendirme, slug, frontmatter, metadata ve içerik arşivi.