Birden çok belge tek bir Markdown dosyasında nasıl birleştirilir

MD Factory her belge için bir Markdown dosyası kaydeder. Tek bir dosya elde etmek için önce belgeleri dönüştürün, ardından Markdown dosyalarını her birinin önüne bir kaynak satırı ekleyen kısa bir PowerShell komutuyla birleştirin.

Sonuç, her belgenin kaynağının adıyla başladığı tek bir dosyadır. Resimler çalışmaya devam eder, çünkü birleştirilmiş dosya görsel klasörlerinin yanında durur.

Leylak rengi bir kıskaçla tutulan kalın bir yığının yanında dört küçük kâğıt yığını ve önde leylak rengi bir kalem. — Birden çok belge, tek dosya.

Tek dosyanın ne zaman işe yaradığı

Tek dosya, bir araç tek yüklemeyi kabul ettiğinde ya da ekleyebileceğiniz dosya sayısını sınırladığında, birkaç belgeyi tek metin olarak okumak istediğinizde veya tüm bir kümeyi tek bir isteme yapıştırmak istediğinizde kullanışlıdır.

Bir kodlama ajanı klasörde arama yapacaksa belge başına bir dosya tutun. Ajan yalnızca ihtiyacı olan dosyayı açabilir ve dosya adı kaynağı gösterir: PDF ve Word dosyalarınızı Claude Code, Cursor ve Codex’e verme. Yalnızca birbirine ait belgeleri birleştirin, çünkü çok uzun bir dosya bir yapay zekâ aracının bir seferde okuyabileceğinden fazla olabilir.

Belgeleri dönüştürün

Birbirine ait belgeleri tek bir klasöre koyun.
MD Factory’yi açın, Klasör ekle’ye tıklayın ve klasörü seçin. Dönüştürme hemen başlar ve her Markdown dosyası orijinalinin yanına kaydedilir.
Her satırda Tamamlandı, İnceleme gerekiyor veya Başarısız görünene kadar bekleyin. Neyi kontrol etmeniz gerektiğini okumak için İnceleme gerekiyor’a tıklayın ve dosyaları birleştirmeden önce bu bölümleri düzeltin.

Aşağıdaki komut bir klasördeki her .md dosyasını birleştirir; bu yüzden yalnızca birleştirilmiş dosyada istediklerinizi dönüştürün. Dâhil olmasını istemiyorsanız Budget (2).md gibi numaralı kopyaları önce silin.

Dosyaları PowerShell ile birleştirin

Dosya Gezgini’nde Markdown dosyalarının bulunduğu klasörü açın.
Adres çubuğuna tıklayın, powershell yazın ve Enter tuşuna basın.
Bu komutu yapıştırın ve Enter tuşuna basın:

$files = Get-ChildItem -Filter *.md | Where-Object Name -ne "combined.md" | Sort-Object Name
$parts = foreach ($file in $files) {
    "Source file: " + $file.Name + "`n`n" + (Get-Content -LiteralPath $file.FullName -Raw -Encoding utf8)
}
$text = $parts -join "`n`n---`n`n"
[System.IO.File]::WriteAllText("$PWD\combined.md", $text, (New-Object System.Text.UTF8Encoding $false))

Sonuç, aynı klasörde combined.md olur. Belgeler alfabetik sırayla birbirini izler. Her biri Source file: annual-report.md gibi bir satırla başlar ve önceki belgeden yatay bir çizgiyle ayrılır.

Komuttaki UTF-8 ayarlarını bırakın: onlar olmadan Windows PowerShell aksanlı ve Latin olmayan harfleri bozabilir.

Sırayı seçmek için komutu çalıştırmadan önce Markdown dosya adlarının başına 01-contract.md gibi bir sayı koyun. Komutu yeniden çalıştırırsanız combined.md değiştirilir ve belgelerden biri olarak okunmaz.

Yalnızca bazı dosyaları birleştirin

Bir klasörün bir kısmını birleştirmek için ilk satırdaki filtreyi değiştirin. Örneğin yalnızca adı 2026- ile başlayan dosyaları almak için:

$files = Get-ChildItem -Filter "2026-*.md" | Sort-Object Name

Komutun geri kalanını olduğu gibi kullanın. Aynı klasörde birkaç birleştirilmiş dosya oluşturursanız komuttaki combined.md’yi değiştirerek her birine kendi adını verin.

Birleştirilmiş dosya nasıl görünür

Source file: contract.md

# Supplier contract

...

---

Source file: handbook.md

# Team handbook

Her belgenin metni değişmez. Yalnızca kaynak satırı ve ayırıcı yenidir.

Birleştirilmiş dosyadaki resimler

Her belgenin resimleri, Markdown dosyasının yanındaki bir klasördedir ve combined.md içindeki bağlantılar bu klasörlere işaret eder. combined.md dosyasını görsel klasörleriyle aynı klasörde tutun. Taşırsanız görsel klasörlerini de onunla birlikte taşıyın.

Komut tek bir klasörün dosyalarını birleştirir. Alt klasörlerdeki belgeler için komutu her alt klasörde çalıştırın; böylece her birleştirilmiş dosya kendi resimlerinin yanında kalır.

Birleştirilmiş dosyayı kontrol edin

Kaynak satırlarını sayın. Bu komut dosyadaki belge sayısını yazdırır; bu sayı Markdown dosyalarının sayısına eşit olmalıdır:

(Select-String -Path combined.md -Pattern "^Source file: " -Encoding utf8).Count

Sonra dosyanın kendisine bakın:

combined.md dosyasını açın ve iki belge arasındaki sınıra kadar kaydırın. Ayırıcı ve kaynak satırı aralarında durmalıdır.
Her belge kendi başlıklarını korur; bu yüzden dosyada birkaç üst düzey başlık bulunur. Kaynak satırları her belgenin nerede başladığını gösterir.
Bir yapay zekâ aracı dosyayı çok uzun olduğu için reddederse kümeyi iki klasöre bölün ve her birini birleştirin.

Sonucu açın veya yükleyin

Not Defteri combined.md dosyasını açar, Visual Studio Code da açar; ayrıca biçimlendirilmiş olarak gösterebilir: Ctrl+Shift+V tuşlarına basın. Diğer uygulamalar şu sayfada listelenir: MD dosyası nedir ve nasıl açılır. Bir yükleme formu .md dosyalarını kabul etmiyorsa adı combined.txt olarak değiştirilmiş bir kopyayı yükleyin.

Belgeleri dosyanın en üstünde listelemek için kaynak satırlarını yazdırın ve yapıştırın:

Select-String -Path combined.md -Pattern "^Source file: " -Encoding utf8 | ForEach-Object Line

Yapay zekâya dosyanın nasıl oluşturulduğunu söyleyin

combined.md dosyasını okuyan bir araç, dosyanın nasıl oluşturulduğunu bildiğinde daha iyi çalışır. İstemin başında kısa bir yönerge yeterlidir:

combined.md dosyasını oku. Her belge
"Source file: name" satırıyla başlar ve yatay bir çizgi
önceki belgeyi bitirir. Yanıt verirken
kullandığın kaynak dosyanın adını belirt.

Yanıtlardan birkaçını adı verilen dosyalarla karşılaştırın. Ad, yalnızca doğruysa işe yarar.

Bir belge değiştiğinde

combined.md bir kopyadır ve belgeleri izlemez. Değişen belgeyi MD Factory’ye yeniden ekleyin, ardından komutu yeniden çalıştırın.

Birleştirilmiş dosya her belgenin metnini içerir; bu yüzden ona orijinallerle aynı özeni gösterin. Klasör buluta eşitleniyorsa dosya da eşitlenir: belgeleri yüklemeden dönüştürme rehberimiz.