Aspose.Cells FOSS
Python
Kako izvesti Excel u Markdown u Pythonu

Kako izvesti Excel u Markdown u Pythonu

Izvoz Excel podataka u Markdown je čest zahtjev za dokumentacijske cjevovode, generatore README‑a i radne tokove statičkih web stranica. Aspose.Cells FOSS for Python to čini operacijom jednim metodom putem workbook.save_as_markdown(): nije potreban Microsoft Office.

Napomena: Aspose.Cells FOSS izvozi u XLSX, CSV, TSV, Markdown i JSON. PDF izvoz nije dio FOSS biblioteke.

Zašto izvesti Excel u Markdown s Aspose.Cells FOSS?

  1. Bez ovisnosti o Officeu: Potpuno se konvertira u Pythonu bez native COM-a ili instalacije Officea.
  2. Podrška u memoriji: Generirajte Markdown stringove bez ikakvog I/O na disku koristeći MarkdownHandler.
  3. Prilagodljiv izlaz: Konfigurirajte ponašanje izvoza putem MarkdownSaveOptions.
  4. Prijateljski prema pipelineu: Integrirajte izravno u generatore dokumentacije, Hugo statičke stranice ili radne tokove GitHub Actions.

Vodič korak po korak

Korak 1: Instalirajte Aspose.Cells FOSS za Python

Instalirajte biblioteku s PyPI-a koristeći pip:

pip install aspose-cells-foss

Provjerite instalaciju:

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

Korak 2: Stvori radnu knjigu i popuni podatke 

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

Korak 3: Izvezi u Markdown

Pozovite workbook.save_as_markdown() s .md izlaznom putanjom:

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

Izlaz je standardna Markdown tablica:

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

Korak 4: Prilagodite pomoću MarkdownSaveOptions

Koristite MarkdownSaveOptions za kontrolu formata izlaza:

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)

Proslijedite instancu MarkdownSaveOptions u save_as_markdown() za konfiguraciju.

Korak 5: Generiraj Markdown u memoriji (bez I/O datoteka)

Koristite MarkdownHandler.save_markdown_to_string() da biste dobili Markdown kao Python string:

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.

Korak 6: Učitaj postojeći XLSX i izvezi u Markdown 

from aspose.cells_foss import Workbook

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

Ovo čuva sve vrijednosti ćelija i osnovnu strukturu. Napomena: Markdown izvoz čita cell.value samo — ćelije koje sadrže samo formulu bez pohranjene vrijednosti pojavit će se prazne u izlazu. Biblioteka ne evaluira formule prilikom izvoza. Kako bi se osiguralo da se rezultati formula prikažu, otvorite datoteku u Excelu ili LibreOfficeu najprije (što evaluira i pohranjuje rezultate formula), spremite kao XLSX, zatim ponovno izvezite.

Korak 7: Obrada pogrešaka

Omotajte izvoze u try/except blokove za proizvodnu upotrebu:

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

Uobičajeni problemi i popravci

1. Prazan Markdown izlaz

Uzrok: Radni list nema popunjene ćelije.
Rješenje: Potvrdite da je ws.cells["A1"].value postavljen i da nije None prije pozivanja save_as_markdown().

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

Cause: Paket nije instaliran ili je korišten pogrešan naziv paketa.
Fix: Pokrenite pip install aspose-cells-foss. Uvoz je from aspose.cells_foss import ... (podvlaka, ne točka).

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

Cause: Instalirali ste pogrešan paket (aspose-cells-python umjesto aspose-cells-foss).
Fix: pip install aspose-cells-foss i potvrdite from aspose.cells_foss import Workbook.

4. Problemi s kodiranjem u izlaznoj datoteci

Cause: Pisanje Markdown stringa u datoteku bez specificiranja UTF-8 kodiranja.
Fix: Koristite MarkdownHandler.save_markdown_to_string() i pišite eksplicitno:

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

Često postavljana pitanja

Mogu li izvesti u PDF umjesto toga?

Ne. Izvoz u PDF nije dostupan u Aspose.Cells FOSS. Koristite komercijalni aspose-cells-python paket za PDF izlaz.

Koje ulazne formate mogu učitati i zatim izvesti u Markdown?

XLSX i CSV datoteke mogu se učitati pomoću Workbook("file.xlsx") i zatim izvesti u Markdown.

Kako izvesti samo jedan list kada postoji više listova?

Po defaultu, save_as_markdown() izvozi prvi radni list. Proslijedite instancu MarkdownSaveOptions za dodatnu konfiguraciju.

Mogu li ovo pokrenuti na Linuxu ili macOS-u?

Da. Biblioteka radi na Windowsu, Linuxu i macOS‑u bez ikakvih platformno‑specifičnih postavki.

Povezani resursi:

 Hrvatski