majiayu000 PDF Tools
PDF 문서를 Markdown 형식으로 변환하여 Claude가 읽고 처리할 수 있도록 합니다.
Instructions
워크플로우: 변환 → 검증 → 정리 → 제공
Step 1: 환경 준비 (최초 1회만)
mise install && mise run setup
Step 2: PDF 변환 실행
기본 변환 (Markdown만):
mise run convert -- <pdf_path> -o <output_path>
페이지 이미지 export (권장):
mise run convert -- <pdf_path> --export-images -o <output_path>
이 옵션은 각 페이지를 JPG 이미지로 <basename>_pages/ 폴더에 저장합니다.
텍스트 변환이 부정확하거나 UI/디자인 문서의 경우 이미지를 Read 도구로 직접 분석할 수 있습니다.
Step 3: 결과 검증 및 분석
텍스트 기반 PDF:
- Read 도구로 출력 Markdown을 읽고 품질 확인
- 필요시 Edit 도구로 자동 정리
UI/디자인 PDF (이미지 export 사용):
<basename>_pages/page_001.jpg등의 이미지 파일을 Read 도구로 직접 확인- 시각적 정보가 중요한 경우 이미지 분석을 우선 사용
Step 4: 자동 정리 (텍스트 변환 품질 개선)
변환 후 반드시 Read 도구로 출력 Markdown을 읽고 품질 문제를 확인하세요.
다음 문제를 발견하면 Edit 도구로 자동 수정:
- 중복 테이블 열: 동일한 내용이 여러 열에 반복되면 제거
- 과도한
<br>태그: 실제 줄바꿈(\n\n)으로 변환하여 가독성 개선 - 빈 테이블: 의미 없는 내용(
•,---만 있는 테이블) 제거 - 섹션 구조 부족: 필요시
## Page N또는## 섹션명헤더 추가
정리 생략 조건:
- 이미 깔끔하게 변환된 경우
- 내용이 간단하고 문제가 없는 경우
- 사용자가 원본 그대로 요청한 경우
Step 4: 사용자에게 제공
정리된 Markdown을 요약하거나 요청받은 분석을 수행하여 제공합니다.
Examples
Example 1: PDF를 Markdown으로 변환
User: "이 PDF를 Markdown으로 변환해줘"
Assistant:
1. mise run convert -- /path/to/document.pdf -o /path/to/document.md
2. Read /path/to/document.md (처음 100줄 확인)
3. 품질 문제 발견 시 Edit로 자동 정리
4. 사용자에게 변환 완료 알림 및 내용 요약 제공
Example 2: PDF 내용 요약 (자동 정리 포함)
User: "invoice.pdf 내용을 요약해줘"
Assistant:
1. mise run convert -- invoice.pdf
2. Read invoice.md
3. 중복 테이블 열, <br> 태그 발견 → Edit로 정리
4. 정리된 내용을 분석하여 요약 제공
Example 3: PDF에서 특정 정보 추출
User: "research_paper.pdf에서 실험 결과 부분만 보여줘"
Assistant:
1. mise run convert -- research_paper.pdf
2. Read research_paper.md
3. 필요시 섹션 헤더 추가하여 구조 개선
4. Markdown에서 실험 결과 섹션을 찾아 제공
Technical Details
상세한 구현 사항과 트러블슈팅은 REFERENCE.md를 참조하세요.