📊 엑셀 시트별 마크다운 변환기 완전 가이드 (CUI)

python --version

pip install aspose-cells-python

from aspose.cells import Workbook
import os
import re

try:
    # 1. 파일 존재 여부 확인
    if not os.path.exists("input.xlsx"):
        print("ERROR: input.xlsx 파일이 없습니다.")
        print("Python 파일과 같은 폴더에 input.xlsx 파일을 넣어주세요.")
        exit()
    
    print("📂 input.xlsx 파일을 처리 중...")
    
    # 2. 엑셀 파일 열기
    workbook = Workbook("input.xlsx")
    
    # 3. 출력 폴더 생성
    base_filename = os.path.splitext("input.xlsx")[0]
    output_dir = f"{base_filename}_sheets"
    
    if not os.path.exists(output_dir):
        os.makedirs(output_dir)
        print(f"📁 출력 폴더 '{output_dir}' 생성했습니다.")
    
    # 4. 시트 개수 확인
    sheet_count = len(workbook.worksheets)
    print(f"📊 총 {sheet_count}개의 시트를 발견했습니다.")
    
    # 5. 통합 파일을 위한 내용 저장소
    combined_content = []
    
    # 6. 각 시트를 개별 MD 파일로 변환
    for i in range(sheet_count):
        print(f"⏳ {i+1}번째 시트 처리 중...")
        
        # 6-1. 새 워크북 생성 및 시트 복사
        new_workbook = Workbook()
        original_sheet = workbook.worksheets[i]
        new_sheet = new_workbook.worksheets[0]
        
        # 6-2. 원본 시트 이름 설정
        new_sheet.name = original_sheet.name
        sheet_name = original_sheet.name
        
        # 6-3. 파일명으로 사용할 수 없는 문자 처리
        safe_sheet_name = re.sub(r'[<>:"/\\|?*]', '_', sheet_name)
        safe_sheet_name = safe_sheet_name.replace(' ', '_')
        safe_sheet_name = safe_sheet_name.strip()
        
        # 6-4. 데이터 복사
        max_row = original_sheet.cells.max_data_row
        max_col = original_sheet.cells.max_data_column
        
        if max_row >= 0 and max_col >= 0:
            for row in range(max_row + 1):
                for col in range(max_col + 1):
                    source_cell = original_sheet.cells.get(row, col)
                    target_cell = new_sheet.cells.get(row, col)
                    target_cell.put_value(source_cell.value)
        
        # 6-5. 개별 MD 파일 저장
        output_filename = os.path.join(output_dir, f"{i+1:02d}_{safe_sheet_name}.md")
        new_workbook.save(output_filename)
        
        # 6-6. 파일 후처리 (불필요한 내용 제거)
        try:
            with open(output_filename, 'r', encoding='utf-8') as f:
                content = f.read()
            
            # "# Evaluation" 이후 모든 내용 제거
            if "# Evaluation" in content:
                content = content.split("# Evaluation")[0].rstrip()
            
            # 마지막 빈 줄들 제거
            content = content.rstrip('\n')
            
            # 수정된 내용으로 파일 다시 저장
            with open(output_filename, 'w', encoding='utf-8') as f:
                f.write(content)
            
            # 통합 파일용 내용 저장
            combined_content.append(content)
                
        except Exception as e:
            print(f"⚠️  파일 후처리 중 오류: {e}")
        
        print(f"✅ {i+1}번째 시트 '{sheet_name}'를 '{output_filename}'로 저장했습니다.")
    
    # 7. 모든 시트를 합친 통합 MD 파일 생성
    print("📝 통합 파일 생성 중...")
    combined_filename = os.path.join(output_dir, f"{base_filename}_ALL_COMBINED.md")
    
    try:
        with open(combined_filename, 'w', encoding='utf-8') as f:
            # 7-1. 목차 생성
            f.write("## 📋 목차\n\n")
            for i in range(sheet_count):
                sheet_name = workbook.worksheets[i].name
                anchor_name = sheet_name.replace(' ', '-').lower()
                f.write(f"{i+1}. [{sheet_name}](#{i+1:02d}-{anchor_name})\n")
            f.write("\n---\n\n")
            
            # 7-2. 각 시트 내용 추가
            for i, content in enumerate(combined_content):
                if content.strip():
                    sheet_name = workbook.worksheets[i].name
                    anchor_name = sheet_name.replace(' ', '-').lower()
                    f.write(f"<div id=\"{i+1:02d}-{anchor_name}\"></div>\n\n")
                    f.write(f"## {i+1:02d}. {sheet_name}\n\n")
                    f.write(content.replace(f"# {sheet_name}", ""))
                    f.write("\n\n---\n\n")
        
        print(f"✅ 통합 파일 '{combined_filename}' 생성 완료!")
        
    except Exception as e:
        print(f"⚠️  통합 파일 생성 중 오류: {e}")
    
    # 8. 완료 메시지 및 결과 출력
    print(f"\n🎉 모든 변환 작업이 완료되었습니다!")
    print(f"📁 '{output_dir}' 폴더에 총 {sheet_count + 1}개의 MD 파일이 생성되었습니다.")
    
    print(f"\n📋 생성된 파일 목록:")
    for filename in sorted(os.listdir(output_dir)):
        if filename.endswith('.md'):
            if "ALL_COMBINED" in filename:
                print(f"   🔗 {filename} (통합파일)")
            else:
                print(f"   - {filename}")
    
except Exception as e:
    print(f"❌ 오류 발생: {e}")
    print("파일이 열려있다면 닫고 다시 시도해주세요.")

python excel_to_markdown.py

# 이 부분을 원하는 파일명으로 변경
if not os.path.exists("your_file.xlsx"):
    print("ERROR: your_file.xlsx 파일이 없습니다.")
    exit()

workbook = Workbook("your_file.xlsx")

# 기본: input_sheets
output_dir = f"{base_filename}_sheets"

# 변경 예시: input_markdown
output_dir = f"{base_filename}_markdown"

# 해결방법: 라이브러리 재설치
pip install aspose-cells-python

import glob

# 폴더 내 모든 .xlsx 파일 처리
for excel_file in glob.glob("*.xlsx"):
    print(f"처리 중: {excel_file}")
    # 위의 변환 코드 실행