여러 문서를 Markdown 파일 하나로 합치는 방법

MD Factory는 문서마다 Markdown 파일을 하나씩 저장합니다. 파일 하나로 만들려면 먼저 문서를 변환한 다음, 각 파일 앞에 출처 줄을 넣는 짧은 PowerShell 명령으로 Markdown 파일을 이어 붙이세요.

결과는 모든 문서가 출처 이름으로 시작하는 파일 하나입니다. 합친 파일이 이미지 폴더 옆에 있으므로 그림도 그대로 표시됩니다.

얇은 종이 더미 네 개와 연보라색 바인더 클립으로 묶인 두꺼운 종이 더미 하나, 그 앞의 연보라색 연필. — 여러 문서, 파일 하나.

파일 하나가 유용한 경우

도구가 업로드를 한 번만 받거나 첨부할 수 있는 파일 수를 제한할 때, 여러 문서를 하나의 텍스트로 읽고 싶을 때, 문서 묶음 전체를 하나의 프롬프트에 붙여 넣고 싶을 때는 파일 하나가 편리합니다.

코딩 에이전트가 폴더를 검색할 때는 문서마다 파일 하나씩 두세요. 필요한 파일만 열 수 있고 파일 이름이 출처를 알려 줍니다. 참고: Claude Code, Cursor, Codex에 PDF와 Word 파일을 넘기는 방법. 함께 속한 문서만 합치세요. 아주 긴 파일은 AI 도구가 한 번에 읽을 수 있는 양을 넘을 수 있습니다.

문서 변환하기

함께 속한 문서를 폴더 하나에 모으세요.
MD Factory를 열고 폴더 추가를 클릭한 다음 그 폴더를 선택하세요. 변환은 바로 시작되며 Markdown 파일은 각각 원본 옆에 저장됩니다.
모든 항목에 완료, 검토 필요, 실패가 표시될 때까지 기다리세요. 검토 필요를 클릭해 확인할 내용을 읽고, 파일을 합치기 전에 해당 부분을 고치세요.

아래 명령은 폴더의 모든 .md 파일을 합치므로, 합친 파일에 넣을 문서만 변환하세요. 넣고 싶지 않다면 Budget (2).md처럼 번호가 붙은 사본을 먼저 삭제하세요.

PowerShell로 파일 합치기

파일 탐색기에서 Markdown 파일이 있는 폴더를 여세요.
주소 표시줄을 클릭하고 powershell을 입력한 뒤 Enter를 누르세요.
이 명령을 붙여 넣고 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))

결과는 같은 폴더의 combined.md입니다. 문서는 알파벳 순서로 이어집니다. 각 문서는 Source file: annual-report.md 같은 줄로 시작하고, 가로줄이 앞 문서와 구분합니다.

명령의 UTF-8 설정은 그대로 두세요. 없으면 Windows PowerShell이 악센트 문자와 비라틴 문자를 깨뜨릴 수 있습니다.

순서를 정하려면 명령을 실행하기 전에 Markdown 파일 이름 앞에 01-contract.md처럼 번호를 붙이세요. 명령을 다시 실행하면 combined.md는 대체되며 문서 중 하나로 읽히지 않습니다.

일부 파일만 합치기

폴더의 일부만 합치려면 첫 줄의 필터를 바꾸세요. 예를 들어 이름이 2026-으로 시작하는 파일만 가져오려면:

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

나머지 명령은 그대로 사용하세요. 한 폴더에서 합친 파일을 여러 개 만든다면 명령의 combined.md를 바꿔 각각 고유한 이름을 지정하세요.

합친 파일의 모양

Source file: contract.md

# Supplier contract

...

---

Source file: handbook.md

# Team handbook

각 문서의 텍스트는 그대로입니다. 출처 줄과 구분선만 새로 들어갑니다.

합친 파일의 그림

각 문서의 그림은 Markdown 파일 옆의 폴더에 있고, combined.md의 링크는 그 폴더를 가리킵니다. combined.md는 이미지 폴더와 같은 폴더에 두세요. 옮긴다면 이미지 폴더도 함께 옮기세요.

이 명령은 폴더 하나의 파일을 합칩니다. 하위 폴더의 문서는 각 하위 폴더에서 명령을 실행해야 합친 파일이 각자의 이미지 옆에 남습니다.

합친 파일 확인하기

출처 줄의 수를 세세요. 이 명령은 파일 안의 문서 수를 출력하며, Markdown 파일의 수와 같아야 합니다:

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

그런 다음 파일 자체를 확인하세요:

combined.md를 열고 두 문서의 경계로 스크롤하세요. 구분선과 출처 줄이 그 사이에 있어야 합니다.
각 문서가 자기 제목을 유지하므로 파일에는 최상위 제목이 여러 개 있습니다. 출처 줄은 각 문서가 시작하는 위치를 보여 줍니다.
AI 도구가 파일이 너무 길다며 거부하면 문서를 폴더 두 개로 나누어 각각 합치세요.

결과 열기 또는 업로드하기

메모장으로 combined.md를 열 수 있으며 Visual Studio Code도 가능합니다. Visual Studio Code에서는 Ctrl+Shift+V를 눌러 서식이 적용된 모습도 볼 수 있습니다. 다른 앱은 다음 문서에 나와 있습니다: MD 파일의 정의와 여는 방법. 업로드 양식이 .md 파일을 받지 않으면 combined.txt로 이름을 바꾼 사본을 업로드하세요.

파일 맨 위에 문서 목록을 넣으려면 출처 줄을 출력해서 붙여 넣으세요:

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

파일의 구조를 AI에 알려 주기

combined.md를 읽는 도구는 파일이 어떻게 구성되었는지 알면 더 잘 작동합니다. 프롬프트 시작 부분에 짧은 지시를 넣으면 충분합니다:

combined.md를 읽으세요. 각 문서는
"Source file: name" 줄로 시작하고, 가로줄이
앞 문서의 끝을 나타냅니다. 답할 때는
사용한 출처 파일의 이름을 밝히세요.

답변 몇 개를 지정된 파일과 대조해 확인하세요. 이름이 정확해야 도움이 됩니다.

문서가 바뀌었을 때

combined.md는 사본이므로 문서를 따라가지 않습니다. 변경된 문서를 MD Factory에 다시 추가한 다음 명령을 다시 실행하세요.

합친 파일에는 모든 문서의 텍스트가 들어 있으므로 원본과 같은 수준으로 주의해서 다루세요. 폴더가 클라우드와 동기화되면 파일도 함께 동기화됩니다. 참고: 문서를 업로드하지 않고 변환하는 방법.