Aspose.Cells FOSS
Python
วิธีส่งออก Excel ไปเป็น Markdown ด้วย Python

วิธีส่งออก Excel ไปเป็น Markdown ด้วย Python

การส่งออกข้อมูล Excel ไปเป็น Markdown เป็นความต้องการทั่วไปสำหรับสายงานเอกสาร, ตัวสร้าง README, และเวิร์กโฟลว์ของเว็บไซต์แบบสถิตย์. Aspose.Cells FOSS for Python ทำให้สิ่งนี้เป็นการดำเนินการด้วยวิธีเดียวผ่าน workbook.save_as_markdown(): ไม่ต้องใช้ Microsoft Office.

หมายเหตุ: Aspose.Cells FOSS ส่งออกเป็น XLSX, CSV, TSV, Markdown, และ JSON. การส่งออกเป็น PDF ไม่ได้เป็นส่วนหนึ่งของไลบรารี FOSS.

ทำไมต้องส่งออก Excel เป็น Markdown ด้วย Aspose.Cells FOSS?

  1. No Office dependency: แปลงทั้งหมดใน Python โดยไม่ต้องใช้ COM หรือการติดตั้ง Office แบบดั้งเดิม.
  2. In-memory support: สร้างสตริง Markdown โดยไม่ต้องทำ I/O กับดิสก์ใด ๆ ด้วยการใช้ MarkdownHandler.
  3. Customizable output: กำหนดค่าพฤติกรรมการส่งออกผ่าน MarkdownSaveOptions.
  4. Pipeline-friendly: ผสานรวมโดยตรงกับเครื่องมือสร้างเอกสาร, เว็บไซต์สถิต Hugo, หรือเวิร์กโฟลว์ของ GitHub Actions.

คู่มือแบบขั้นตอนต่อขั้นตอน

ขั้นตอนที่ 1: ติดตั้ง Aspose.Cells FOSS สำหรับ Python

ติดตั้งไลบรารีจาก PyPI โดยใช้ pip:

pip install aspose-cells-foss

ตรวจสอบการติดตั้ง:

from aspose.cells_foss import Workbook
print("Ready.")

ขั้นตอนที่ 2: สร้าง Workbook และใส่ข้อมูล 

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]

##Headers
ws.cells["A1"].value = "Product"
ws.cells["B1"].value = "Q1 Revenue"
ws.cells["C1"].value = "Q2 Revenue"

##Data rows
ws.cells["A2"].value = "Widget A"
ws.cells["B2"].value = 12500
ws.cells["C2"].value = 15000

ws.cells["A3"].value = "Widget B"
ws.cells["B3"].value = 8750
ws.cells["C3"].value = 9200

ws.cells["A4"].value = "Widget C"
ws.cells["B4"].value = 20000
ws.cells["C4"].value = 22500

ขั้นตอนที่ 3: ส่งออกเป็น Markdown

เรียก workbook.save_as_markdown() ด้วย .md เส้นทางผลลัพธ์:

workbook.save_as_markdown("report.md")
print("Markdown saved successfully.")

ผลลัพธ์เป็นตาราง Markdown มาตรฐาน:

| Product | Q1 Revenue | Q2 Revenue |
|---|---|---|
| Widget A | 12500 | 15000 |
| Widget B | 8750 | 9200 |
| Widget C | 20000 | 22500 |

ขั้นตอนที่ 4: ปรับแต่งด้วย MarkdownSaveOptions

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
ws.cells["A3"].value = "Tokyo"
ws.cells["B3"].value = 13960000

options = MarkdownSaveOptions()

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

ส่งอินสแตนซ์ MarkdownSaveOptions ไปยัง save_as_markdown() เพื่อการกำหนดค่า.

ขั้นตอนที่ 5: สร้าง Markdown ในหน่วยความจำ (ไม่มีการอ่าน/เขียนไฟล์)

ใช้ MarkdownHandler.save_markdown_to_string() เพื่อรับ Markdown เป็นสตริง Python:

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"
ws.cells["A3"].value = "license"
ws.cells["B3"].value = "MIT"

md_string = MarkdownHandler.save_markdown_to_string(workbook)
print(md_string)
##Use md_string in an API response, a GitHub README template, etc.

ขั้นตอนที่ 6: โหลดไฟล์ XLSX ที่มีอยู่แล้วและส่งออกเป็น Markdown 

from aspose.cells_foss import Workbook

workbook = Workbook("existing_report.xlsx")
workbook.save_as_markdown("existing_report.md")
print("Markdown export complete.")

นี่จะรักษาค่าของเซลล์ทั้งหมดและโครงสร้างพื้นฐานไว้ หมายเหตุ: การส่งออกเป็น Markdown จะอ่าน cell.value เท่านั้น — เซลล์ที่มีเพียงสูตรโดยไม่มีค่าที่เก็บไว้จะปรากฏเป็นช่องว่างในผลลัพธ์. ไลบรารีไม่ประมวลผลสูตรในขณะส่งออก. เพื่อให้ผลลัพธ์ของสูตรแสดงขึ้น, เปิดไฟล์ใน Excel หรือ LibreOffice ก่อน (ซึ่งจะประมวลผลและเก็บค่าผลลัพธ์ของสูตร), บันทึกเป็น XLSX, แล้วส่งออกใหม่.

ขั้นตอนที่ 7: การจัดการข้อผิดพลาด

ห่อการส่งออกในบล็อก try/except สำหรับการใช้งานในสภาพการผลิต:

from aspose.cells_foss import Workbook

def export_to_markdown(xlsx_path: str, md_path: str) -> bool:
    try:
        workbook = Workbook(xlsx_path)
        workbook.save_as_markdown(md_path)
        return True
    except FileNotFoundError:
        print(f"Input file not found: {xlsx_path}")
        return False
    except Exception as e:
        print(f"Export failed for {xlsx_path}: {e}")
        return False

ปัญหาทั่วไปและการแก้ไข

1. ผลลัพธ์ Markdown ว่าง

Cause: แผ่นงานไม่มีเซลล์ที่มีข้อมูล.
Fix: ยืนยันว่า ws.cells["A1"].value ถูกตั้งค่าและไม่เป็น None ก่อนเรียกใช้ save_as_markdown().

2. ModuleNotFoundError: No module named 'aspose.cells_foss'

Cause: แพคเกจไม่ได้ติดตั้งหรือใช้ชื่อแพคเกจผิด
Fix: เรียกใช้ pip install aspose-cells-foss. การนำเข้าคือ from aspose.cells_foss import ... (ขีดล่าง, ไม่ใช่จุด)

3. AttributeError: 'Workbook' object has no attribute 'save_as_markdown'

Cause: คุณได้ติดตั้งแพ็คเกจผิด (aspose-cells-python แทน aspose-cells-foss).
Fix: pip install aspose-cells-foss และยืนยัน from aspose.cells_foss import Workbook.

4. ปัญหาเรื่องการเข้ารหัสในไฟล์ผลลัพธ์

Cause: การเขียนสตริง Markdown ไปยังไฟล์โดยไม่ได้ระบุการเข้ารหัส UTF-8.
Fix: ใช้ MarkdownHandler.save_markdown_to_string() และเขียนอย่างชัดเจน:

with open("output.md", "w", encoding="utf-8") as f:
    f.write(md_string)

คำถามที่พบบ่อย

ฉันสามารถส่งออกเป็น PDF แทนได้ไหม?

ไม่. การส่งออก PDF ไม่พร้อมใช้งานใน Aspose.Cells FOSS. ใช้แพคเกจเชิงพาณิชย์ aspose-cells-python สำหรับการส่งออก PDF.

รูปแบบไฟล์อินพุตใดบ้างที่ฉันสามารถโหลดแล้วส่งออกเป็น Markdown ได้?

ไฟล์ XLSX และ CSV สามารถโหลดด้วย Workbook("file.xlsx") แล้วส่งออกเป็น Markdown ได้.

ฉันจะส่งออกเฉพาะแผ่นเดียวเมื่อมีหลายแผ่นได้อย่างไร?

โดยค่าเริ่มต้น, save_as_markdown() ส่งออกแผ่นงานแรก. ส่งผ่านอินสแตนซ์ของ MarkdownSaveOptions เพื่อการกำหนดค่าเพิ่มเติม.

ฉันสามารถรันสิ่งนี้บน Linux หรือ macOS ได้หรือไม่?

ใช่. ไลบรารีทำงานบน Windows, Linux และ macOS โดยไม่ต้องตั้งค่าที่เฉพาะเจาะจงสำหรับแพลตฟอร์มใดๆ

แหล่งข้อมูลที่เกี่ยวข้อง:

 ภาษาไทย