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 zahtev za dokumentacione pipeline‑ove, generatore README‑a i radne tokove statičkih sajtova. Aspose.Cells FOSS for Python omogućava ovo kao operaciju jednim metodom putem workbook.save_as_markdown(): nije potreban Microsoft Office.

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

Zašto izvoziti Excel u Markdown uz Aspose.Cells FOSS?

  1. Bez zavisnosti od Office-a: Konvertuje se u potpunosti u Python-u bez native COM ili instalacije Office-a.
  2. Podrška u memoriji: Generišite Markdown stringove bez ikakvog I/O na disku koristeći MarkdownHandler.
  3. Prilagodljiv izlaz: Konfigurišite ponašanje izvoza putem MarkdownSaveOptions.
  4. Prijateljski prema pipeline-u: Integrirajte direktno u generatore dokumentacije, Hugo statičke sajtove ili radne tokove GitHub Actions.

Vodič korak po korak

Korak 1: Instalirajte Aspose.Cells FOSS za Python

Instalirajte biblioteku sa PyPI koristeći pip:

pip install aspose-cells-foss

Proverite instalaciju:

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

Korak 2: Kreirajte Workbook i popunite 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: Izvoz u Markdown

Pozovite workbook.save_as_markdown() sa .md putanjom izlaza:

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

Izlaz je standardna Markdown tabela:

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

Korak 4: Prilagodite pomoću MarkdownSaveOptions

MarkdownSaveOptions Koristite MarkdownSaveOptions za kontrolu formata izlaza: ⟦/PH_0017⟧

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)

Prosledite instancu MarkdownSaveOptions u save_as_markdown() za konfiguraciju.

Korak 5: Generišite Markdown u memoriji (bez I/O fajlova)

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čitajte postojeći XLSX i izvezite 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 vrednosti ćelija i osnovnu strukturu. Napomena: Markdown izvoz čita cell.value samo — ćelije koje sadrže samo formulu bez keširane vrednosti pojaviće se prazno u izlazu. Biblioteka ne procenjuje formule prilikom izvoza. Da biste osigurali da se rezultati formula prikažu, otvorite fajl u Excelu ili LibreOffice‑u prvo (što procenjuje i kešira rezultate formula), sačuvajte kao XLSX, zatim ponovo izvezite.

Korak 7: Obrada grešaka

Umotajte izvoz u try/except blokove za upotrebu u produkciji:

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. Prazan Markdown izlaz

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

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

Uzrok: Paket nije instaliran ili je korišćen pogrešan naziv paketa.
Rešenje: Pokrenite pip install aspose-cells-foss. Uvoz je from aspose.cells_foss import ... (donja crta, a ne tačka).

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

Uzrok: You installed the wrong package (aspose-cells-python instead of aspose-cells-foss).
Rešenje: pip install aspose-cells-foss and confirm from aspose.cells_foss import Workbook.

4. Problemi sa kodiranjem u izlaznoj datoteci

Uzrok: Pisanje Markdown niza u datoteku bez navođenja UTF-8 kodiranja.
Rešenje: 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 da izvezem u PDF umesto?

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

Koje ulazne formate mogu da učitam, a zatim izvezem u Markdown?

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

Kako da izvezem samo jedan list kada postoji više listova?

Podrazumevano, save_as_markdown() izvozi prvi radni list. Prosledite instancu MarkdownSaveOptions za dodatnu konfiguraciju.

Могу ли да покренем ово на Linux-у или macOS-у?

Da. Biblioteka radi na Windows, Linux i macOS bez ikakvog platformno‑specifičnog podešavanja.

Povezani resursi:

 Српски