Como combinar vários documentos em um único arquivo Markdown

O MD Factory salva um arquivo Markdown para cada documento. Para ter um arquivo só, converta primeiro os documentos e depois junte os arquivos Markdown com um comando curto do PowerShell que adiciona uma linha de origem antes de cada um.

O resultado é um arquivo em que cada documento começa com o nome da origem. As imagens continuam funcionando, porque o arquivo combinado fica ao lado das pastas de imagens.

Quatro pequenas pilhas de papel ao lado de uma pilha grossa presa por um clipe lilás, com um lápis lilás na frente. — Vários documentos, um arquivo.

Quando um arquivo ajuda

Um arquivo único é prático quando uma ferramenta aceita um só envio ou limita quantos arquivos você pode anexar, quando você quer ler vários documentos como um único texto ou quando quer colar um conjunto inteiro em um prompt.

Mantenha um arquivo por documento quando um agente de programação for pesquisar a pasta. Ele pode abrir só o arquivo de que precisa, e o nome do arquivo indica a origem: veja como dar ao Claude Code, ao Cursor e ao Codex os seus PDFs e arquivos Word. Combine apenas documentos que fazem parte do mesmo conjunto, porque um arquivo muito longo pode ser mais do que uma ferramenta de IA lê de uma vez.

Converta os documentos

Reúna em uma pasta os documentos que fazem parte do mesmo conjunto.
Abra o MD Factory, clique em Adicionar pasta e escolha essa pasta. A conversão começa na hora, e cada arquivo Markdown é salvo ao lado do original.
Espere até todas as linhas mostrarem Concluído, Precisa de revisão ou Falhou. Clique em Precisa de revisão para ler o que conferir e corrija essas partes antes de juntar os arquivos.

O comando abaixo junta todos os arquivos .md de uma pasta, então converta só o que você quer no arquivo combinado. Apague antes as cópias numeradas, como Budget (2).md, se não quiser que entrem nele.

Junte os arquivos com o PowerShell

No Explorador de Arquivos, abra a pasta com os arquivos Markdown.
Clique na barra de endereços, digite powershell e pressione Enter.
Cole este comando e pressione 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))

O resultado é combined.md na mesma pasta. Os documentos aparecem um após o outro em ordem alfabética. Cada um começa com uma linha como Source file: annual-report.md, e uma linha horizontal o separa do documento anterior.

Mantenha as configurações de UTF-8 no comando: sem elas, o Windows PowerShell pode embaralhar letras acentuadas e não latinas.

Para escolher a ordem, coloque um número no início dos nomes dos arquivos Markdown, como 01-contract.md, antes de executar o comando. Se você executar o comando de novo, combined.md é substituído e não é lido como um dos documentos.

Junte só alguns dos arquivos

Para juntar parte de uma pasta, mude o filtro na primeira linha. Por exemplo, para pegar só os arquivos cujos nomes começam com 2026-:

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

Use o restante do comando como está. Se você montar vários arquivos combinados na mesma pasta, dê um nome próprio a cada um mudando combined.md no comando.

Como é o arquivo combinado

Source file: contract.md

# Supplier contract

...

---

Source file: handbook.md

# Team handbook

O texto de cada documento não muda. Só a linha de origem e o separador são novos.

Imagens no arquivo combinado

As imagens de cada documento estão em uma pasta ao lado do arquivo Markdown dele, e os links em combined.md apontam para essas pastas. Mantenha combined.md na mesma pasta que as pastas de imagens. Se você o mover, mova as pastas de imagens junto.

O comando junta os arquivos de uma pasta. Para documentos em subpastas, execute-o em cada subpasta, para que cada arquivo combinado fique ao lado das próprias imagens.

Confira o arquivo combinado

Conte as linhas de origem. Este comando mostra o número de documentos no arquivo, que deve ser igual ao número de arquivos Markdown:

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

Depois olhe o próprio arquivo:

Abra combined.md e role até a divisa entre dois documentos. O separador e a linha de origem devem estar entre eles.
Cada documento mantém os próprios títulos, então o arquivo tem vários títulos de nível mais alto. As linhas de origem mostram onde cada documento começa.
Se uma ferramenta de IA rejeitar o arquivo por ser longo demais, divida o conjunto em duas pastas e combine cada uma.

Abra ou envie o resultado

O Bloco de Notas abre combined.md, e o Visual Studio Code também, e ele ainda pode mostrá-lo formatado: pressione Ctrl+Shift+V. Outros aplicativos estão listados em o que é um arquivo MD e como abri-lo. Se um formulário de envio não aceitar arquivos .md, envie uma cópia renomeada para combined.txt.

Para listar os documentos no início do arquivo, exiba as linhas de origem e cole-as:

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

Explique à IA como o arquivo é montado

Uma ferramenta que lê combined.md funciona melhor quando sabe como o arquivo é montado. Uma instrução curta no início do prompt basta:

Leia combined.md. Cada documento começa com uma linha
"Source file: name", e uma linha horizontal encerra o
documento anterior. Ao responder, cite o arquivo
de origem que você usou.

Confira algumas respostas com os arquivos citados. O nome só ajuda se estiver certo.

Quando um documento muda

combined.md é uma cópia e não acompanha os documentos. Adicione de novo o documento alterado ao MD Factory e execute o comando outra vez.

O arquivo combinado contém o texto de todos os documentos, então trate-o com o mesmo cuidado que os originais. Se a pasta sincroniza com a nuvem, o arquivo também sincroniza: veja como converter documentos sem enviá-los.