Windows PowerShell 기준 | PDF → Markdown 일괄 변환
1. 개요
MarkItDown은 PDF, Word, Excel, PPT 등의 문서를 AI가 읽기 쉬운 Markdown(.md) 파일로 변환하는 도구입니다.
https://github.com/microsoft/markitdown
2. 설치 방법
PowerShell을 실행한 후 아래 명령어를 입력합니다.
① pip 업데이트
python -m pip install --upgrade pip② MarkItDown 설치
일반 사용자:
pip install "markitdown[all]"GitHub 소스코드를 다운로드한 경우:
cd C:\Users\BJE\Desktop\markitdown-main\packages\markitdown
python -m pip install -e ".[all]"③ 설치 확인
markitdown --help도움말이 표시되면 정상 설치된 것입니다.
3. PDF 파일 1개 변환
markitdown "원본파일.pdf" -o "변환파일.md"예시:
markitdown "C:\Users\BJE\Desktop\test.pdf" -o "C:\Users\BJE\Desktop\test.md"4. PDF 파일 일괄 변환
지정 폴더에 있는 PDF를 모두 Markdown으로 변환합니다.
# 1. 원본 PDF 폴더 지정
$inputFolder = "C:\Users\BJE\Downloads\drive-download-20261028T233405Z-1-001"
# 2. 결과 저장 폴더 지정
$outputFolder = Join-Path $inputFolder "markdown"
# 3. 결과 폴더 생성
New-Item -ItemType Directory -Force -Path $outputFolder | Out-Null
# 4. PDF 일괄 변환
Get-ChildItem $inputFolder -Filter "*.pdf" -File |
ForEach-Object {
$outputFile = Join-Path $outputFolder ($_.BaseName + ".md")
markitdown $_.FullName -o $outputFile
}실행 방법: 코드를 PowerShell에 복사하여 붙여넣고 실행합니다. 다른 폴더를 변환하려면 $inputFolder 경로만 변경하면 됩니다.
5. 변환 결과 확인
구분위치
| 원본 PDF | 지정한 입력 폴더 |
| 변환된 MD | 입력 폴더 내 markdown 폴더 |
| 파일명 | 원본 파일명 유지, 확장자만 .md로 변경 |
6. 주의사항
-
원본 PDF는 삭제하거나 수정하지 않습니다.
-
동일한 이름의 MD 파일이 있으면 덮어쓸 수 있습니다.
-
이미지 기반 스캔 PDF는 별도 OCR이 필요할 수 있습니다.
-
표, 이미지, 복잡한 레이아웃은 원본과 다르게 변환될 수 있습니다.
-
기본 일괄 변환 코드는 하위 폴더를 검색하지 않습니다.
핵심: 최초 1회 설치 후에는 PowerShell에서 입력 폴더 경로만 변경하여 반복 사용할 수 있습니다.