Features

Python용 스프레드시트 형식 내보내기

Aspose.Cells FOSS for Python provides straightforward export from Excel workbooks to every format the FOSS library supports. A single workbook.save() call은 전체 출력 파이프라인 — XLSX, CSV, TSV, Markdown, 또는 JSON — 을 처리하며, Microsoft Office 없이도 셀 값과 수식을 보존합니다.

설치 및 설정

pip install aspose-cells-foss

핵심 클래스를 가져옵니다:

from aspose.cells_foss import Workbook, SaveFormat, Cell
from aspose.cells_foss import MarkdownHandler, MarkdownSaveOptions
from aspose.cells_foss import CSVSaveOptions

지원되는 출력 형식

형식	SaveFormat 상수	참고
XLSX	`SaveFormat.XLSX`	기본 형식; 스타일, 수식, 차트를 보존합니다
CSV	`SaveFormat.CSV`	쉼표 구분; 기본적으로 첫 번째 시트만 포함
TSV	`SaveFormat.TSV`	탭 구분 값
Markdown	`SaveFormat.MARKDOWN`	표준 Markdown 테이블을 생성합니다
JSON	`SaveFormat.JSON`	시트 데이터의 구조화된 JSON 표현

중요: Aspose.Cells FOSS는 않음 PDF, HTML, PNG, TIFF, DOCX, 또는 PPTX로의 내보내기를 지원하지 않습니다. 이러한 기능은 상용 aspose-cells-python 패키지에서만 제공됩니다.

사용 예시

XLSX로 저장

저장 시 기본 형식은 .xlsx 확장:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Product"
ws.cells["B1"].value = "Revenue"
ws.cells["A2"].value = "Widget A"
ws.cells["B2"].value = 12500
ws.cells["A3"].value = "Widget B"
ws.cells["B3"].value = 8750

workbook.save("report.xlsx")

CSV로 저장

from aspose.cells_foss import Workbook, Cell, SaveFormat

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Age"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 30
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 25

workbook.save("data.csv", SaveFormat.CSV)

Markdown으로 저장

표 데이터를 Markdown 표로 내보내기 — 문서화 및 README 생성에 유용합니다:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "First name"
ws.cells["B1"].value = "Age"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 30
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 25

workbook.save_as_markdown("data.md")

출력은 표준 Markdown 표입니다:

| First name | Age |
|---|---|
| Alice | 30 |
| Bob | 25 |

옵션이 있는 Markdown

사용 MarkdownSaveOptions 세밀한 제어를 위해:

from aspose.cells_foss import Workbook, Cell, MarkdownSaveOptions

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "City"
ws.cells["B1"].value = "Population"
ws.cells["A2"].value = "London"
ws.cells["B2"].value = 9000000

options = MarkdownSaveOptions()

workbook.save_as_markdown("cities.md", options)

Markdown을 문자열로 (메모리 내) 변환

디스크에 쓰지 않고 Markdown 문자열을 생성합니다:

from aspose.cells_foss import Workbook, Cell, MarkdownHandler

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Key"
ws.cells["B1"].value = "Value"
ws.cells["A2"].value = "version"
ws.cells["B2"].value = "26.3.0"

md_string = MarkdownHandler.save_markdown_to_string(workbook)
print(md_string)

JSON으로 저장

워크북 데이터를 구조화된 JSON으로 내보내어 API 파이프라인에 사용합니다:

from aspose.cells_foss import Workbook, Cell, SaveFormat

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 95.5
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 88.0

workbook.save("data.json", SaveFormat.JSON)

CSV를 로드하고 XLSX로 저장

from aspose.cells_foss import Workbook, SaveFormat

workbook = Workbook()
workbook.load_csv("input.csv")
workbook.save("output.xlsx", SaveFormat.XLSX)

팁 및 모범 사례

Markdown으로 내보내기

사용 MarkdownHandler.save_markdown_to_string(wb) API 응답과 같은 인메모리 사용 사례에 대해.

CSV 내보내기

CSV 내보내기는 기본적으로 첫 번째 워크시트를 기록합니다.
셀 값에 포함된 특수 문자(쉼표, 줄바꿈)는 자동으로 따옴표로 감싸집니다.

JSON 내보내기

JSON 내보내기는 셀 주소를 키로 사용합니다. 데이터 교환에 적합하며, 복잡한 수식은 문자열 표현으로 저장됩니다.

일반적인 문제 및 해결책

문제	해결
`ModuleNotFoundError: No module named 'aspose.cells_foss'`	실행 `pip install aspose-cells-foss` 그리고 가상 환경이 활성화되어 있는지 확인합니다
`AttributeError` 켜짐 `SaveFormat.PDF`	PDF 내보내기는 FOSS 라이브러리에 포함되어 있지 않습니다; 사용 `SaveFormat.MARKDOWN` 또는 `SaveFormat.XLSX` 대신
빈 Markdown 출력	저장하기 전에 시트에 최소 하나의 셀에 값이 있는지 확인하십시오
Markdown에서 인코딩 문제	사용 `MarkdownHandler.save_markdown_to_string()` 전체 인코딩 제어가 가능한 인메모리 문자열 출력용

자주 묻는 질문

어떤 출력 형식이 Aspose.Cells FOSS에서 지원되나요? XLSX, CSV, TSV, Markdown, 및 JSON.

PDF로 변환할 수 있나요? 아니요. PDF 내보내기에는 상용 aspose-cells-python 패키지. Aspose.Cells FOSS는 XLSX, CSV, TSV, Markdown, 및 JSON으로만 내보냅니다.

기존 XLSX를 로드하고 Markdown으로 다시 저장할 수 있나요? 예. Workbook("existing.xlsx") 파일을 로드하고, workbook.save_as_markdown("output.md") 내보냅니다.

스트림 기반 Markdown 출력이 지원됩니까? 예. 사용 MarkdownHandler.save_markdown_to_string(workbook) 파일 I/O 없이 Python 문자열로 Markdown을 가져오려면.