Markdown.new Nedir Ve URL’leri Temiz Markdown’a Nasıl Dönüştürür?

Kısa yanıt: markdown.new, herhangi bir URL’yi veya desteklenen dosyayı temiz ve yapılandırılmış Markdown’a dönüştüren ücretsiz bir hizmettir. Ben aracı yapay zekâ ajanlarının ham HTML yerine daha az gürültülü içerik kullanabilmesi için geliştirdim. Bir web adresinin başına markdown.new/ ekleyebilir, dosya yükleyebilir veya aynı dönüşümü API üzerinden çağırabilirsiniz.

Cloudflare tabanlı üç aşamalı sistem kullanır: önce yerel içerik uzlaşması, ardından Workers AI dönüşümü ve son yedek olarak başsız tarayıcıyla işleme. Amaç, her istekte ham HTML’ye göre yüzde 80’e kadar daha az token kullanan uygun Markdown çıktısını sağlamaktır.

I built https://t.co/TegRO9wVZF

Put https://t.co/aJjJVn3uHO before any URL → get clean Markdown back.

Cloudflare's Markdown for Agents is great, but only works for enabled sites. https://t.co/TegRO9wVZF works for ANY website on the internet.

80% fewer tokens. Also converts… https://t.co/ZfWGOLRUyN

— Emre Elbeyoglu (@elbeyoglu) February 14, 2026

Araç ham HTML’ye göre token tüketimini yüzde 80’e kadar azaltabilir, kaynak site yerel Markdown desteklemese de URL’lerle çalışır ve PDF, Word belgesi, OCR kullanılan görsel ve transkripsiyon yapılan ses gibi dosyaları dönüştürebilir.

Time to consider not just human visitors, but to treat agents as first-class citizens. Cloudflare’s network now supports real-time content conversion to Markdown at the source using content negotiation headers.https://t.co/B7wYH4PtA8

— Cloudflare (@Cloudflare) February 12, 2026

Web’den temiz içerik almak neden zor?

Web, yalnızca metin okumak için değil tarayıcıda sayfa oluşturmak için geliştirildi. RAG akışında sayfa ayrıştıran yapay zekâ ajanı da temiz not almak isteyen insan da gezinme çubukları, betik etiketleri, CSS sınıfları ve içeriği örten iç içe <div> öğeleriyle karşılaşıyor.

Cloudflare’ın Markdown for Agents duyurusuna göre Markdown’daki basit bir ## Hakkımızda başlığı yaklaşık 3 token kullanırken HTML karşılığı <h2 class="section-title" id="about">Hakkımızda</h2> 12-15 token tüketiyor. Cloudflare’ın kendi blog yazısı HTML’de 16.180 tokendan Markdown’da 3.150 tokana düşüyor; bu yaklaşık yüzde 80 azalma demek.

RAG akışı, araştırma ajanı veya içerik özetleyici geliştiriyorsanız bu kayıp hızla büyür. Sorun yalnızca yapay zekâya özgü değildir. Dokümantasyon hazırlayan, içeriği statik siteye taşıyan, bilgi bankası kuran veya web yazısını temiz biçimde saklamak isteyen herkes aynı engelle karşılaşır. HTML sayfa oluşturmak için iyi, okumak, saklamak ve yeniden kullanmak için gürültülüdür.

markdown.new’u internetteki URL’lerde bu sorunu çözmek için geliştirdim.

Cloudflare Markdown for Agents nasıl çalışır?

Cloudflare Şubat 2026’da Markdown for Agents özelliğini tanıttı. Sistem içerik uzlaşması başlıklarını kullanarak HTML’yi uç noktada gerçek zamanlı Markdown’a dönüştürüyor.

Yapay zekâ ajanı Cloudflare özelliği açık bir siteye Accept: text/markdown isteği gönderdiğinde ağ HTML’yi Markdown’a çeviriyor. Yanıt iki yararlı başlık içeriyor: bağlam penceresi bütçesi için tahmini token sayısını veren x-markdown-tokens ve yayıncının Content Signals çerçevesi kapsamındaki yapay zekâ kullanım iznini bildiren Content-Signal.

Çözümün belirli sınırları bulunuyor:

Beta özellik için bunlar anlaşılır sınırlardır; ancak internetin büyük bölümü ajanlara hâlâ ham HTML sunuyor.

markdown.new herhangi bir URL’yi nasıl Markdown’a dönüştürür?

markdown.new yalnızca Cloudflare özelliği açık sitelerde değil, farklı URL’lerde çalışmak üzere tasarlandı. En hızlı yöntemi önce deneyen ve gerektiğinde sıradaki yönteme geçen üç aşamalı sistem kullanıyor. İsteği yapan ajan hangi yöntemin seçildiğini bilmek zorunda kalmıyor.

1. yöntem: İçerik uzlaşması

İlk istek, Cloudflare Markdown for Agents ile aynı mekanizmayı kullanarak sayfayı Accept: text/markdown başlığıyla getirir:

fetch(url, { headers: { Accept: "text/markdown" } })

Hedef site içerik uzlaşmasını destekliyorsa Markdown doğrudan uç noktadan gelir ve ek dönüştürme yapılmaz. İçerik sahibi sayfanın Markdown görünümünü belirlemiştir; yanıt bağlam planlaması için x-markdown-tokens, yapay zekâ kullanım izinleri için Content-Signal başlıklarını içerebilir.

2. yöntem: Workers AI toMarkdown

İçerik uzlaşması Markdown yerine HTML döndürürse mevcut yanıt Cloudflare Workers AI toMarkdown() işlevinden geçirilir:

env.AI.toMarkdown([{ name: "page.html", blob: htmlBlob }])

İkinci kez getirme gerekmez; eldeki HTML aynı anda dönüştürülür. Workers AI toMarkdown() farklı belge türlerini işler, anlamlı yapıyı korurken gereksiz şablon öğelerini ayıklar. Bu yol statik sitelerin çoğunu kapsar.

3. yöntem: Tarayıcıyla oluşturma

Ham HTML’nin yalnızca <script> etiketi içeren boş kabuk olduğu tek sayfa uygulamalarında ve istemci tarafı sayfalarda, içerik Cloudflare Browser Rendering API üzerinden başsız tarayıcıda oluşturulur:

POST /browser-rendering/markdown
{ "url": "https://..." }

Bu en yavaş yöntemdir; JavaScript ağırlıklı sayfaların dönüştürülebilmesi için son yedek olarak çalışır.

markdown.new hangi üç yolla kullanılabilir?

Çalışma şeklinize göre URL’yi üç yolla dönüştürebilirsiniz:

1. Tarayıcıda URL’nin başına ekleyin:

https://markdown.new/https://example.com/any-page

2. markdown.new web arayüzünü kullanın: URL yapıştırın veya PDF, Word, Excel, PowerPoint, görsel ya da ses dosyası yükleyip dönüştürün.

3. Ajan veya veri akışından programlı çağrı yapın: Hedef URL’yi adrese ekleyin. API anahtarı, yapılandırma ve kayıt gerekmez.

Markdown yapay zekâ ajanlarının performansını neden etkiler?

Markdown yalnızca HTML’den küçük değildir. Başlık, liste, vurgu, kod bloğu ve tablo gibi anlamlı yapıları modellerin daha kolay işleyebileceği biçimde korur. Ajan akışları geliştirirken üç yarar gördüm.

Token verimliliği maliyeti ve bağlamı doğrudan etkiler. RAG akışında yüzlerce URL işlenirken yüzde 80 daha az token, tek bağlam penceresine yaklaşık beş kat daha fazla kaynak sığdırabilir. Büyük ölçekte çalışan ajanlarda bu durum API çağrısı maliyetini azaltabilir.

Yapılandırılmış içerik LLM çıktısını iyileştirir. Ajan ## Fiyatlandırma başlığının ardından temiz Markdown tablosu gördüğünde hiyerarşiyi, rastgele CSS sınıflarıyla iç içe geçmiş <div> öğelerine göre daha kolay anlar. Princeton ve Georgia Tech’in KDD 2024’te yayımlanan GEO çalışması, karşılaştırma tabloları gibi yapıların yapay zekâ atıf olasılığını yüzde 32,5 artırdığını bildiriyor.

Tutarlı girdi mimariyi sadeleştirir. markdown.new olmadan tipik içerik alma sistemi; sayfa oluşturma için Puppeteer, HTML temizleme için Beautiful Soup, ek düzenlemeler için özel regex ve PDF ile belgeler için ayrı işleyiciler gerektirir. markdown.new bu bileşenleri tek URL önekinde birleştirir.

markdown.new URL dışında hangi dosyaları dönüştürebilir?

URL’den Markdown’a dönüşüm temel özelliktir; web arayüzü dosya yüklemelerini de destekler:

OCR ve ses transkripsiyonunu kendi ajan akışlarımda tekrar tekrar ihtiyaç duyduğum için ekledim: yüklenen PDF’leri okuyan destek botu, makale alan araştırma yardımcısı veya kayıt işleyen toplantı özetleyicisi. Tek dönüştürücü bunların tamamını ele alıyor.

markdown.new yapay zekâya hazır web’e nasıl uyum sağlar?

Cloudflare’ın Markdown for Agents duyurusu sektördeki değişime işaret ediyor. Accept: text/markdown üzerinden içerik uzlaşması standart protokole dönüşüyor; Content Signals çerçevesi yayıncıların yapay zekâ kullanım haklarını açıkça bildirmesine imkân veriyor. Claude Code ve OpenCode gibi kodlama ajanları isteklerinde bu kabul başlıklarını kullanıyor.

Ancak geçiş dönemindeyiz. Çoğu site Markdown for Agents özelliğini açmadı; birçoğu Cloudflare üzerinde çalışmıyor. markdown.new, web’in gittiği yer ile bugün bulunduğu yer arasındaki boşluğu dolduruyor.

Yerel Markdown varsa onu kullanıyor, standart HTML sitelerini Workers AI ile işliyor ve başka yöntem çalışmadığında JavaScript ağırlıklı sayfayı oluşturuyor. Kaynak sitenin desteklediği özellikten bağımsız olarak ajana tutarlı Markdown vermeyi hedefliyor.

markdown.new nasıl kullanılmaya başlanır?

Herhangi bir URL’nin başına markdown.new/ ekleyin:

https://markdown.new/https://blog.cloudflare.com/markdown-for-agents/

Programlı kullanımda hedef URL’yi adrese ekleyerek HTTP isteği gönderin. Dosya dönüşümleri için markdown.new web arayüzünü kullanın.

API anahtarı, kayıt veya yapılandırma gerekmez. Web tarayıcılar, Markdown ise ajanların okuması için uygundur. markdown.new henüz yerel Markdown sunmayan sayfalar dahil web içeriğini ajanların okuyabileceği biçime dönüştürür.

Markdown ve yapay zekâ ajanları konusunda sırada ne okuyabilirsiniz?

• PDF, DOCX ve görseller için ücretsiz dosyadan Markdown dönüştürücü rehberimi inceleyin.
• Dönüştürülen içeriği kullanan sistemleri yapay zekâ ajanları rehberimde öğrenin.
• Yapının kaynak gösterilebilirliğe etkisini SEO ve GEO içerik kontrol listemde değerlendirin.