MarkItDown nedir? Microsoft'un PDF ve Word dosyalarını yapay zekâya hazırlayan aracı

Yapay zekâya bir PDF verdiğinde arka planda ilk iş o PDF'in metne çevrilmesi. Bu çeviri kötü yapılırsa tablolar birbirine girer, başlıklar kaybolur, sayfa numaraları cümlelerin ortasına düşer. Model de bu karmaşadan anlamaya çalışır ve cevabın kalitesi düşer.

Microsoft'un geliştirdiği MarkItDown, tam bu ilk adımı düzgün yapmak için var. Ekim 2026 itibarıyla GitHub'da yaklaşık 189 bin yıldızıyla dünyanın en popüler yapay zekâ yardımcı araçlarından biri.

Ne yapıyor

MarkItDown, elindeki dosyayı Markdown formatına çeviriyor. Desteklediği formatlar:

• PDF
• Word, Excel, PowerPoint
• HTML sayfaları
• Resimler (içindeki yazıları ve bilgileri okuyarak)
• Ses dosyaları (konuşmayı yazıya dökerek)
• CSV, JSON, XML
• ZIP dosyaları (içindekileri tek tek işleyerek)
• YouTube linkleri ve e-kitaplar (EPUB)

Çıktı, başlıkların başlık, tabloların tablo, listelerin liste olarak korunduğu sade bir metin.

Neden Markdown

Projenin kendi açıklaması bunu güzel anlatıyor: büyük dil modelleri Markdown'ı neredeyse ana dilleri gibi konuşuyor. Eğitim verilerinde çok fazla Markdown metin gördükleri için bu formattaki yapıyı çok iyi anlıyorlar. Hatta sen istemesen bile cevaplarını çoğu zaman Markdown ile biçimlendiriyorlar.

İkinci avantaj tasarruf. Markdown çok az işaret kullandığı için aynı belge, örneğin HTML haline göre çok daha az token tutuyor. Token nedir yazımızda anlattığımız gibi, bu doğrudan daha uzun dayanan kota ve daha düşük API faturası demek.

Kimlerin işine yarar

• Büyük belge arşiviyle çalışanlar: Avukatlık büroları, akademisyenler, muhasebe ekipleri. Yüzlerce belgeyi tek komutla yapay zekâya hazır hale getirmek mümkün.
• Kendi yapay zekâ asistanını kuranlar: Open WebUI gibi araçlarla "belgelerime sor" sistemi kuranlar için temiz bir giriş verisi.
• Yazılımcılar: Python koduna iki satırla eklenebiliyor.
• Meraklı kullanıcılar: Bir PDF'i ChatGPT'ye vermeden önce gerçekten ne gördüğünü merak edenler.

Kurulum

MarkItDown bir Python aracı ve resmi README'ye göre Python 3.10 ile 3.14 arası sürümleri destekliyor. Önce bir sanal ortam oluşturmak öneriliyor, böylece bilgisayarındaki diğer Python araçlarıyla çakışmaz:

python -m venv .venv
source .venv/bin/activate
pip install 'markitdown[all]'

[all] kısmı tüm dosya türleri için gereken ek parçaları kurar. Sadece birkaç türe ihtiyacın varsa daha hafif bir kurulum yapabilirsin:

pip install 'markitdown[pdf, docx, pptx]'

Kullanım

En basit hali tek satır:

markitdown sozlesme.pdf -o sozlesme.md

Bu komut sozlesme.pdf dosyasını okur ve sonucu sozlesme.md dosyasına yazar. Sonra bu dosyanın içeriğini istediğin yapay zekâya verebilirsin.

Pratik bir örnek akış:

1. Uzun bir şartnameyi MarkItDown ile Markdown'a çevir.
2. Çıkan metni yapay zekâya yapıştır.
3. Şu tarz bir soru sor:

Aşağıdaki şartnameyi sadece bu metne dayanarak incele.
Teslim tarihlerini, cezai şartları ve ödeme koşullarını ayrı
başlıklar altında listele. Metinde olmayan bir şey ekleme.

Son cümle önemli: modeli verdiğin metne bağlı tutmak uydurma riskini ciddi şekilde azaltıyor. Bunun neden işe yaradığını yapay zekâ neden uyduruyor yazısında anlattık.

Bir güvenlik notu

README'de açıkça yazan bir uyarı var: MarkItDown dosyaları ve adresleri, onu çalıştıran kullanıcının yetkileriyle açar. Kendi bilgisayarında kendi belgelerinle kullanırken sorun yok. Ama başkalarından gelen dosyaları ya da linkleri otomatik işleyen bir sistem kuruyorsan, bu girdileri kontrol etmen gerekiyor.

Kısacası

MarkItDown gösterişli bir araç değil; arka planda çalışan, sıkıcı ama kritik bir işi iyi yapan bir yardımcı. Yapay zekâyla belge üzerinde çok çalışıyorsan, cevapların kalitesini artırmanın en ucuz yollarından biri.

Sıradaki yazı Claude Code nedir, nasıl kurulur? Türkçe başlangıç rehberi