Come unire più documenti in un unico file Markdown

MD Factory salva un file Markdown per ogni documento. Per ottenere un unico file, converti prima i documenti, poi unisci i file Markdown con un breve comando PowerShell che aggiunge una riga di origine prima di ciascuno.

Il risultato è un unico file in cui ogni documento inizia con il nome della sua origine. Le immagini continuano a funzionare, perché il file unito si trova accanto alle cartelle delle immagini.

Quattro piccole pile di carta accanto a una pila spessa tenuta da una molletta lilla, con una matita lilla davanti. — Più documenti, un solo file.

Quando un unico file è utile

Un unico file è comodo quando uno strumento accetta un solo caricamento o limita il numero di file allegabili, quando vuoi leggere più documenti come un solo testo o quando vuoi incollare un intero insieme in un unico prompt.

Tieni un file per documento quando un agente di programmazione cercherà nella cartella. Può aprire solo il file che gli serve e il nome del file indica l'origine: vedi come dare a Claude Code, Cursor e Codex i tuoi file PDF e Word. Unisci solo documenti che stanno insieme, perché un file molto lungo può superare ciò che uno strumento IA legge in una volta.

Converti i documenti

Metti in una cartella i documenti che stanno insieme.
Apri MD Factory, fai clic su Aggiungi cartella e sceglila. La conversione parte subito e ogni file Markdown viene salvato accanto all'originale.
Attendi che ogni riga mostri Completato, Da controllare o Non riuscito. Fai clic su Da controllare per leggere cosa verificare e correggi quelle parti prima di unire i file.

Il comando qui sotto unisce tutti i file .md di una cartella, quindi converti solo ciò che vuoi nel file unito. Elimina prima le copie numerate come Budget (2).md se non vuoi includerle.

Unisci i file con PowerShell

In Esplora file apri la cartella con i file Markdown.
Fai clic sulla barra degli indirizzi, digita powershell e premi Invio.
Incolla questo comando e premi Invio:

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

Il risultato è combined.md nella stessa cartella. I documenti si susseguono in ordine alfabetico. Ognuno inizia con una riga come Source file: annual-report.md, e una linea orizzontale lo separa dal documento precedente.

Mantieni le impostazioni UTF-8 nel comando: senza, Windows PowerShell può rovinare le lettere accentate e non latine.

Per scegliere l'ordine, metti un numero all'inizio dei nomi dei file Markdown, come 01-contract.md, prima di eseguire il comando. Se esegui di nuovo il comando, combined.md viene sostituito e non viene letto come uno dei documenti.

Unisci solo alcuni file

Per unire solo una parte di una cartella, cambia il filtro nella prima riga. Per esempio, per prendere solo i file i cui nomi iniziano con 2026-:

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

Usa il resto del comando così com'è. Se crei più file uniti nella stessa cartella, dai a ciascuno un nome diverso cambiando combined.md nel comando.

Com'è fatto il file unito

Source file: contract.md

# Supplier contract

...

---

Source file: handbook.md

# Team handbook

Il testo di ogni documento resta invariato. Sono nuove solo la riga di origine e il separatore.

Immagini nel file unito

Le immagini di ogni documento sono in una cartella accanto al suo file Markdown e i link in combined.md puntano a quelle cartelle. Tieni combined.md nella stessa cartella delle cartelle delle immagini. Se lo sposti, sposta con lui le cartelle delle immagini.

Il comando unisce i file di una cartella. Per i documenti nelle sottocartelle, eseguilo in ciascuna sottocartella, così ogni file unito resta accanto alle proprie immagini.

Controlla il file unito

Conta le righe di origine. Questo comando stampa il numero di documenti nel file, che deve essere uguale al numero di file Markdown:

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

Poi guarda il file stesso:

Apri combined.md e scorri fino al confine tra due documenti. Il separatore e la riga di origine devono trovarsi tra di essi.
Ogni documento mantiene i propri titoli, quindi il file ha più titoli di primo livello. Le righe di origine mostrano dove inizia ogni documento.
Se uno strumento IA rifiuta il file perché troppo lungo, dividi l'insieme in due cartelle e unisci ciascuna.

Apri o carica il risultato

Il Blocco note apre combined.md, così come Visual Studio Code, che può anche mostrarlo formattato: premi Ctrl+Shift+V. Altre app sono elencate in cos'è un file MD e come aprirlo. Se un modulo di caricamento non accetta file .md, carica una copia rinominata in combined.txt.

Per elencare i documenti all'inizio del file, stampa le righe di origine e incollale:

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

Spiega all'IA com'è fatto il file

Uno strumento che legge combined.md funziona meglio se sa com'è fatto il file. Basta una breve istruzione all'inizio del prompt:

Leggi combined.md. Ogni documento inizia con una riga
"Source file: name", e una linea orizzontale chiude il
documento precedente. Quando rispondi, indica il file
sorgente che hai usato.

Controlla alcune risposte con i file indicati. Il nome è utile solo se è giusto.

Quando un documento cambia

combined.md è una copia e non segue i documenti. Aggiungi di nuovo a MD Factory il documento modificato, poi esegui di nuovo il comando.

Il file unito contiene il testo di ogni documento, quindi trattalo con la stessa cura degli originali. Se la cartella si sincronizza con il cloud, si sincronizza anche il file: vedi come convertire i documenti senza caricarli.