Cara menggabungkan beberapa dokumen menjadi satu file Markdown

MD Factory menyimpan satu file Markdown untuk setiap dokumen. Untuk mendapatkan satu file, konversikan dokumennya dulu, lalu gabungkan file Markdown dengan perintah PowerShell singkat yang menambahkan baris sumber sebelum masing-masing.

Hasilnya satu file dengan setiap dokumen diawali nama sumbernya. Gambarnya tetap berfungsi, karena file gabungan berada di samping folder-folder gambar.

Empat tumpukan kecil kertas di samping satu tumpukan tebal yang dijepit klip pengikat lilac, dengan pensil lilac di depannya. — Beberapa dokumen, satu file.

Kapan satu file berguna

Satu file berguna jika sebuah alat hanya menerima satu unggahan atau membatasi jumlah file yang bisa dilampirkan, jika Anda ingin membaca beberapa dokumen sebagai satu teks, atau jika Anda ingin menempelkan seluruh set ke satu prompt.

Gunakan satu file per dokumen jika agen pemrograman akan mencari di folder. Agen bisa membuka hanya file yang diperlukan, dan nama file menunjukkan sumbernya: lihat cara memberi Claude Code, Cursor, dan Codex akses ke PDF dan file Word Anda. Gabungkan hanya dokumen yang saling berkaitan, karena file yang sangat panjang bisa melebihi yang dibaca alat AI sekaligus.

Konversikan dokumennya

Kumpulkan dokumen yang saling berkaitan dalam satu folder.
Buka MD Factory, klik Tambahkan folder, lalu pilih folder itu. Konversi langsung dimulai, dan setiap file Markdown disimpan di samping aslinya.
Tunggu sampai setiap baris menampilkan Selesai, Perlu diperiksa, atau Gagal. Klik Perlu diperiksa untuk membaca apa yang perlu dicek, dan perbaiki bagian itu sebelum menggabungkan file.

Perintah di bawah menggabungkan setiap file .md dalam folder, jadi konversikan hanya yang ingin Anda masukkan ke file gabungan. Hapus dulu salinan bernomor seperti Budget (2).md jika Anda tidak ingin menyertakannya.

Gabungkan file dengan PowerShell

Di File Explorer, buka folder berisi file Markdown.
Klik bilah alamat, ketik powershell, lalu tekan Enter.
Tempel perintah ini dan tekan Enter:

$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))

Hasilnya combined.md di folder yang sama. Dokumen disusun berurutan menurut abjad. Masing-masing diawali baris seperti Source file: annual-report.md, dan garis horizontal memisahkannya dari dokumen sebelumnya.

Pertahankan pengaturan UTF-8 dalam perintah: tanpanya, Windows PowerShell bisa merusak huruf beraksen dan non-Latin.

Untuk menentukan urutan, beri nomor di awal nama file Markdown, seperti 01-contract.md, sebelum menjalankan perintah. Jika Anda menjalankan perintah lagi, combined.md diganti dan tidak dibaca sebagai salah satu dokumen.

Gabungkan sebagian file saja

Untuk menggabungkan sebagian folder, ubah filter di baris pertama. Misalnya, untuk mengambil hanya file yang namanya diawali 2026-:

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

Gunakan sisa perintah apa adanya. Jika Anda membuat beberapa file gabungan dalam satu folder, beri masing-masing nama sendiri dengan mengubah combined.md dalam perintah.

Tampilan file gabungan

Source file: contract.md

# Supplier contract

...

---

Source file: handbook.md

# Team handbook

Teks setiap dokumen tidak berubah. Hanya baris sumber dan pemisahnya yang baru.

Gambar di file gabungan

Gambar setiap dokumen berada di folder di samping file Markdown-nya, dan tautan di combined.md menunjuk ke folder-folder itu. Biarkan combined.md di folder yang sama dengan folder gambar. Jika Anda memindahkannya, pindahkan juga folder gambarnya.

Perintah ini menggabungkan file dalam satu folder. Untuk dokumen di subfolder, jalankan di setiap subfolder, agar setiap file gabungan tetap berada di samping gambarnya sendiri.

Periksa file gabungan

Hitung baris sumbernya. Perintah ini mencetak jumlah dokumen di file, yang seharusnya sama dengan jumlah file Markdown:

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

Lalu lihat file-nya sendiri:

Buka combined.md dan gulir ke batas antara dua dokumen. Pemisah dan baris sumber harus berada di antaranya.
Setiap dokumen mempertahankan judulnya sendiri, jadi file memiliki beberapa judul tingkat atas. Baris sumber menunjukkan awal setiap dokumen.
Jika alat AI menolak file karena terlalu panjang, bagi set itu ke dua folder dan gabungkan masing-masing.

Buka atau unggah hasilnya

Notepad membuka combined.md, begitu juga Visual Studio Code, yang juga bisa menampilkannya dengan format: tekan Ctrl+Shift+V. Aplikasi lain tercantum di apa itu file MD dan cara membukanya. Jika formulir unggah tidak menerima file .md, unggah salinan yang diganti namanya menjadi combined.txt.

Untuk mendaftar dokumen di bagian atas file, cetak baris sumber dan tempelkan:

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

Beri tahu AI cara file disusun

Alat yang membaca combined.md bekerja lebih baik jika tahu cara file disusun. Instruksi singkat di awal prompt sudah cukup:

Baca combined.md. Setiap dokumen diawali baris
"Source file: name", dan garis horizontal mengakhiri
dokumen sebelumnya. Saat menjawab, sebutkan file
sumber yang Anda gunakan.

Cocokkan beberapa jawaban dengan file yang disebutkan. Nama itu hanya berguna jika benar.

Saat dokumen berubah

combined.md adalah salinan dan tidak mengikuti perubahan dokumen. Tambahkan lagi dokumen yang berubah ke MD Factory, lalu jalankan perintah lagi.

File gabungan berisi teks semua dokumen, jadi perlakukan dengan kehati-hatian yang sama seperti aslinya. Jika folder disinkronkan ke cloud, file ini ikut disinkronkan: lihat cara mengonversi dokumen tanpa mengunggahnya.