Bir belge bağlam penceresi için çok büyük olduğunda, yalnızca ihtiyacınız olan kısmı dönüştürün. GroupDocs.Markdown.Mcp, bir AI ajanının seçilen sayfaları veya çalışma sayfalarını yerel olarak Markdown’a dönüştürmesine olanak tanır; Claude Desktop, Claude Code, Cursor veya GitHub Copilot üzerinden, böylece LLM tüm kitabı değil, bir bölümü okur:
handbook.pdf dosyasının 40’tan 52’ye kadar olan sayfalarını Markdown’a dönüştür.
Yapılandırma ve sorun giderme adımlarıyla birlikte adım adım sürüm belgelerde bulunabilir: Bir belgenin yalnızca bir bölümünü Markdown’a nasıl dönüştürürsünüz.
Kapsamlı dönüşüm ne kadar tasarruf sağlar?
Bir istemde kullandığınız her kelime model sağlayıcısı tarafından okunur, faturalandırılır ve diğer tüm kelimelerle dikkat için rekabet eder. Uzun bir belgeyle ilgili çoğu soru, belgenin küçük bir kısmıyla ilgilidir. Önce her şeyi dönüştürüp ardından modeli çoğunu görmezden gelmeye zorlamak, her soruda tüm belge için ödeme yapmanıza neden olur.
Tasarrufu, sahip olduğunuz bir belge üzerinde ölçmek kolaydır. İşte yöntemi belirtilmiş gerçek bir ölçüm. Dosya, bu sunucunun belgelerdeki kendi lisanslama sayfasının Markdown kaynağıdır. Ön bilgi kısmından sonra bölüp, boşlukla ayrılmış kelimeleri, kod bloklarını ve Hugo kısa kod işaretlemelerini saydık (kısa kodlar olmadan tüm sayfa 810 kelimedir). Tablo, bir bölüm ile sayfa arasındaki oranı gösterir; bu, sayfaları seçen pages seçeneğinin (başlıkları değil) ölçülmüş bir sonucu değildir:
| Sayfanın bölümü | Kelime |
|---|---|
| Giriş ve üç lisanslama modu | 167 |
| Değerlendirme modu sınırlamaları | 93 |
| Lisans uygulama | 78 |
| Ölçülen (kullanım başına ödeme) lisanslama | 366 |
| Hangi modun aktif olduğunu doğrulama | 113 |
| Lisans alma | 27 |
| Tüm sayfa | 844 |
Hangi lisans modunun aktif olduğu sorusu sadece 113 kelimelik bölümü gerektirir. Bu, sayfanın yaklaşık %13’ü ya da bütünün yaklaşık 7,5 katı kadar kısadır. Sayım kelimelerle yapılmıştır çünkü tokenlar modelin tokenleştiricisine bağlıdır; token sayısı kelime sayısıyla hareket eder ve ölçülmemiş bir token rakamı eklemedik. Sayfa kasıtlı olarak kısadır. El kitabınız daha büyük olacak ve oranı kendiniz sayacaksınız.
Yöntem 1: Hangi sayfaları doğrudan belirtebilirim?
Sayfaları biliyorsanız, belirtin. convert_to_markdown üzerindeki pages parametresi, "40,41,42" gibi virgülle ayrılmış 1‑tabanlı sayı listesi alır. Parametrede aralık sözdizimi yoktur; ajan “40 to 52” ifadesini sizin için listeye genişletir. pages parametresini bırakmazsanız tüm belge dönüştürülür.
handbook.pdf dosyasının 40’tan 52’ye kadar olan sayfalarını Markdown’a dönüştür.
Sonuç, kaydedilmiş bir .md dosyası ve satır içi döndürülen içeriktir. Uzun çıktı satır içinde kırpılır, kaydedilen dosya ise tam metni tutar.
Yöntem 2: Sadece 3. bölümü nasıl dönüştürürüm?
Araç başlık‑kapsamlı bir seçenek sunmaz, bu yüzden “bölüm 3” önce sayfa numaralarına dönüştürülmelidir. Bunu iki küçük adımda yapın:
handbook.pdf dosyasının kaç sayfası var ve başlığı nedir?
get_document_info dosyayı dönüştürmeden yanıt verir: pageCount, title, author, fileFormat ve isEncrypted. Ayrıca bir şifre gerektiğinde erken uyarır. Sonra içindekiler sayfalarını dönüştürün, okuyun ve adlandırdıkları aralığı isteyin.
Örnek oturum (kısaltılmış):
You: How many pages does handbook.pdf have, and what is its title?
Agent: get_document_info -> pageCount: 212, title: "Operations Handbook".
You: Convert pages 3 to 4 (the table of contents), then convert chapter 3.
Agent: convert_to_markdown (pages: "3,4") -> contents read: chapter 3 runs pages 61 to 64.
convert_to_markdown (pages: "61,62,63,64") -> saved chapter 3 as Markdown.
İki küçük dönüşüm, bir büyük dönüşümün yerini alır.
Yöntem 3: Bir çalışma kitabından tek bir çalışma sayfasını nasıl alırım?
XLSX, XLS ve ODS dosyalarında sayılar, basılı sayfalar yerine çalışma sayfalarını seçer:
modelin 2. çalışma sayfasını Markdown’a dönüştür.
Bu, aynı çalışma kitabındaki diğer sayfalar olmadan tek bir tabloyu belgeye ekler.
Kapsamlı dönüşüm ek adım için ne zaman değerli olur?
- Context. LLM, soruya yanıt veren kısmı alır ve uzun belgeler pencere içinde kalır.
- Metered cost. Ölçülen lisanslama altında işlediğiniz şey için faturalandırılırsınız, bu yüzden daha az sayfa daha düşük fatura demektir.
- Retrieval quality. Tek ilgili ekini tutan bir indeks, her sorguda geri kalan katalogla seyrelmez.
Eğer bütün belge işi ise, kapsamlandırmayın. Bir kez dönüştürün ve Markdown’u koruyun.
Dürüst sınırlamalar: değerlendirme modundaki sayfalar
Lisans olmadan sunucu değerlendirme modunda çalışır: yalnızca ilk 3 sayfa işlenir ve her birine bir değerlendirme filigranı eklenir. Bu, pages parametresini geçersiz kılar. Değerlendirme modunda 40‑52 sayfalarını istemek, hata vermeden 1‑3 sayfalarını döndürür; bu yüzden lisanssız bir kitap ortasındaki bölümü test etmek mümkün değildir. Çıktı beklediğiniz yerde başlamazsa önce get_license_status çağırın.
Bir içindekiler tablosu basılı sayfa etiketlerini kullanabilir. Dönüştürülen sayfalar beklenen başlıkta başlamazsa, ajanı komşu sayfaları dönüştürmeye ve listeyi ayarlamaya yönlendirin; get_document_info toplam sayfa sayısını verir ve listeyi buna göre sınırlar.
SSS
Sadece 3. bölümü Markdown’a nasıl dönüştürürüm?
Önce bölümün sayfa numaralarını bulun, ardından pages içinde iletin. Ajanı içindekiler sayfalarını dönüştürmeye, okumaya ve verdikleri aralığı talep etmeye yönlendirin.
Bağlam penceresi için bir belge çok büyük olduğunda ne yapmalıyım?
Belgenin sadece bir kısmını dönüştürün, tamamını değil. pages kullanarak sorunuza yanıt veren sayfaları veya çalışma sayfalarını seçin ve başlamadan önce get_document_info ile sayfa sayısını kontrol edin.
AI ile PDF sayfaları 10’dan 20’ye kadar Markdown’a dönüştürebilir miyim?
Evet. Düz bir dille sorun, “report.pdf dosyasının 10‑20 sayfalarını Markdown’a dönüştür”, ve ajan sayfa numaralarının genişletilmiş listesini gönderir. Lisanssız durumda yalnızca ilk 3 sayfa işlenir.
Daha derine in
- Documentation, canonical how-to: Bir belgenin yalnızca bir bölümünü Markdown’a nasıl dönüştürürsünüz
- Documentation hub: GroupDocs.Markdown MCP Server
- Start here: RAG boru hattınız Markdown ile başlar — bu adımı yerel tutun
- Related: Docs-as-code geçişini otomatikleştirin: ajan dönüşümü çalıştırır, siz gözden geçirirsiniz
- Related: Belgelerden statik siteye: Hugo, Docusaurus veya MkDocs bir AI ajanı aracılığıyla
- On-premise and security model: AI belge işleme için 3 mimari ve dosyaları ağınız içinde tutan yapı
- Questions: GroupDocs Markdown forumu
- Source: GroupDocs.Markdown.Mcp on GitHub