문서 → 마크다운 변환기
DOCX·PDF·PPTX를 자동 후처리까지 거친 고품질 마크다운으로 변환해 주는 스킬.
문서·오피스중급★ 1,323⑂ 212AI 점수 9/10마지막 업데이트: 2026. 8. 8.
무엇을 해주나
Word(DOCX), PDF, PowerPoint(PPTX), Excel(XLSX) 파일을 마크다운으로 변환합니다. 단순 변환이 아니라 Pandoc·pymupdf4llm·MarkItDown 등 여러 도구를 문서 형식별로 자동 선택해 사용하고, 변환 후 다음 8가지를 자동으로 고칩니다.
- 깨진 grid 표 → 파이프 표 또는 인용구
media/media/같은 중첩 이미지 경로 정리{width="..."}같은 Pandoc 속성 찌꺼기 제거- 한중일 문자 주변
**굵게**간격 보정(렌더링 깨짐 방지) - 들여쓰기 코드블록 → 언어 감지 후 ``` 펜스 변환
- 이스케이프된 대괄호·이중 대괄호 링크 정리
또한 Quick 모드(빠름)와 Heavy 모드(여러 도구를 병렬 실행해 구간별 최상 결과를 병합)를 지원하며, 변환 품질 검증(텍스트/표/이미지 보존율)과 HTML 리포트 생성, PDF 이미지 추출, Windows↔WSL 경로 변환 스크립트까지 포함합니다.
이런 분께 추천
- 사내 Word 문서를 Git/위키용 마크다운으로 옮겨야 하는 기획자·개발자
- 논문·리포트 PDF를 LLM에 넣기 좋은 텍스트로 정리하려는 연구자
- 한글·중국어·일본어 문서 변환 시 굵게 표시가 깨지는 문제로 고생한 분
- 여러 문서를 한 번에 변환해 문서 사이트를 구축하려는 팀
활용 예시
- "이 제안서 docx를 마크다운으로 변환해줘" → 표와 이미지가 살아있는
output.md와./media폴더 생성. - "논문 PDF에서 그림만 따로 뽑아줘" →
extract_pdf_images.py로 페이지·위치 메타데이터가 담긴 이미지 세트 추출. - "변환 품질이 괜찮은지 확인해줘" →
validate_output.py로 텍스트 95% 이상 보존 여부를 검사하고 HTML 리포트 출력.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 daymade/claude-code-skills 의 daymade-docs/doc-to-markdown 폴더를 내 ~/.claude/skills/doc-to-markdown/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-docs/doc-to-markdown ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 사전 도구를 설치합니다:
brew install pandoc(macOS, 윈도우는 choco/scoop 사용), 그리고pip install uv pymupdf4llm,uv tool install "markitdown[pdf]". - 저장소를 내려받습니다:
git clone https://github.com/daymade/claude-code-skills.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r claude-code-skills/daymade-docs/doc-to-markdown ~/.claude/skills/ - Claude Code를 재시작한 뒤 "이 docx를 마크다운으로 변환해줘"라고 요청하면 스킬이 자동으로 호출됩니다.
- (선택) 정상 동작 확인:
uv run --with pytest pytest ~/.claude/skills/doc-to-markdown/scripts/test_convert.py -v
GitHub에서 원본 보기 ↗라이선스: MIT