홈 / Skills / 사무·문서 / Excel을 Markdown으로 변환
사무·문서

Excel을 Markdown으로 변환

awesome-copilot communityMITSkill 언어: 영어
라이선스 확인됨스크립트 포함중간 위험
데모실행 기록 · claude-sonnet-5-5 · 2026년 10월
I have a workbook at .claude/skills/convert-excel-to-md/sales.xlsx with our Q3 sales. Please tell me the total revenue for each product, which region has a missing value, and the refunded units per region. The Python interpreter that has markitdown installed is /private/tmp/claude-501/-Users-huipeizhu-git-aibars-portal/1db8d52d-0133-4843-9915-dc2b4b4fafd0/scratchpad/mdtest/.venv/bin/python — use it by that exact path, and use relative paths for the script and the workbook.
Skill: convert-excel-to-md
Read: sales/sales.md

Revenue totals (from the Revenue column of the Q3 Sales sheet):

  • Widget: 1,900 (North 1,140 + South 760)
  • Gadget: 1,800 (East 1,080 + North 720). West's Gadget row has no revenue value, so it isn't included.

Missing value: West. The 2026-07-05 Gadget row has no Units and no Revenue. The unit price is 24.0, so the revenue can't be worked out without the units.

The sheet's own Total row shows 3,700 revenue and 275 units. That matches the sum of the rows that have values (1,900 + 1,800 = 3,700), so the total also leaves out West's missing sale.

Refunded units per region (Refunds sheet):

  • East: 3
  • North: 2
  • South and West: none listed, so presumably 0.

I converted the workbook to Markdown, and the output is in .claude/skills/convert-excel-to-md/sales/sales.md.

试用方式:Skill 的 Python 脚本需要 markitdown 包,我在隔离的临时环境里装好,并在提示词里给出解释器路径;Bash 只放行这条脚本命令。示例工作簿是我构造的(含一个有意留空的单元格和一张退款表)。模型的数字与我用代码复算的结果一致:Widget 1,900、Gadget 1,800、合计 3,700。

하는 일

MarkItDown을 기반으로 한 동봉 Python 스크립트로 .xlsx 통합 문서를 Markdown 표로 바꿔, 모델이 데이터를 안정적으로 분석하고 요약하고 추출할 수 있게 합니다. 통합 문서에 포함된 이미지는 img/ 폴더로 추출되고, 각 시트 섹션에서 해당 이미지로 연결됩니다. 파일 하나나 폴더 안의 여러 통합 문서(재귀 가능)에 쓸 수 있으며, 출력은 원본 옆의 <이름>/ 폴더나 -o로 지정한 폴더에 생성됩니다.

동작 방식

  1. references/setup.md에 따라 한 번만 환경을 준비합니다(Python, pip, markitdown[xlsx]).
  2. python scripts/convert_excel_to_md.py <파일 또는 폴더> [-o <출력 폴더>] [--recursive]를 실행합니다.
  3. 모델이 생성된 <이름>.md를 읽습니다.

이런 때 좋습니다

스프레드시트에 대해 질문하거나, 데이터를 뽑거나, 요약할 때.

참고 및 위험

중간 위험:Python 스크립트를 실행하며 `markitdown[xlsx]`의 `pip install`이 필요합니다. 설치 문서의 Linux 단계는 `sudo apt-get install`을 쓰며 관리자 권한이 필요합니다. `<이름>/<이름>.md`와 `img/` 폴더를 쓰며, 대상 폴더에 이미 `img/` 폴더가 있으면 이미지를 추출하기 전에 그 폴더를 삭제합니다(삭제되는 것은 이 하위 폴더뿐). 바뀌어도 괜찮은 출력 폴더를 고르세요. 이 스킬의 설명은 `.xlsx`를 보면 항상 이 스크립트를 실행하고 PDF·Word용 자매 스킬도 함께 호출하라고 모델에게 지시하는데, 그 자매 스킬들은 이 사이트에 등록되어 있지 않습니다. 스크립트는 네트워크 요청을 하지 않습니다. 시험 실행했고 몇 가지 제한을 확인했습니다: 격리된 임시 환경에서 스크립트를 실행했고(단일 파일, 일괄, 재귀와 -o, `.xls`와 없는 경로 거부) 결과는 정확했습니다. 다만 빈 셀은 `NaN`(날짜는 `NaT`)으로, 빈 칸이 있는 정수 열은 `120.0`으로 표시됩니다. 셀에 `|`가 있으면 이스케이프되지 않아 표가 어긋납니다. Excel에서 한 번도 열어 저장하지 않은 파일(코드로 생성한 것 등)은 수식 셀에 캐시 값이 없어 NaN으로 나옵니다. 손상된 `.xlsx`는 실패로 처리되지 않고 원문이 `.md`로 쓰여 성공으로 표시됩니다. 실측으로 확인: `-o`가 이미 `img/`가 있는 폴더를 가리키면 그 안의 파일이 삭제됩니다.