Aspose.Cells FOSS
Python
Cum să exportați Excel în Markdown în Python

Cum să exportați Excel în Markdown în Python

Exportarea datelor Excel în Markdown este o cerință comună pentru fluxurile de documentație, generatoarele README și fluxurile de lucru ale site‑urilor statice. Aspose.Cells FOSS for Python face această operație cu o singură metodă prin workbook.save_as_markdown(): nu este necesar Microsoft Office.

Notă: Aspose.Cells FOSS exportă în XLSX, CSV, TSV, Markdown și JSON. Exportul PDF nu face parte din biblioteca FOSS.

De ce să exportați Excel în Markdown cu Aspose.Cells FOSS?

  1. Fără dependență de Office: Convertește complet în Python fără COM nativ sau instalare Office.
  2. Suport în memorie: Generează șiruri Markdown fără niciun I/O pe disc utilizând MarkdownHandler.
  3. Ieșire personalizabilă: Configurează comportamentul de export prin MarkdownSaveOptions.
  4. Prietenos cu pipeline-urile: Integrează direct în generatoare de documentație, site-uri statice Hugo sau fluxuri de lucru GitHub Actions.

Ghid pas cu pas

Pasul 1: Instalați Aspose.Cells FOSS pentru Python

Instalați biblioteca din PyPI utilizând pip:

pip install aspose-cells-foss

Verificați instalarea:

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

Pasul 2: Creați un registru de lucru și completați datele 

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

Pasul 3: Exportă în Markdown

Apelă workbook.save_as_markdown() cu o cale de ieșire .md:

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

Ieșirea este un tabel Markdown standard:

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

Pasul 4: Personalizați cu MarkdownSaveOptions

Folosiți MarkdownSaveOptions pentru a controla formatul de ieșire:

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)

Transmiteți o instanță MarkdownSaveOptions către save_as_markdown() pentru configurare.

Pasul 5: Generare Markdown în memorie (Fără I/O de fișiere)

Folosiți MarkdownHandler.save_markdown_to_string() pentru a obține Markdown-ul ca șir 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.

Pasul 6: Încarcă un fișier XLSX existent și exportă în Markdown 

from aspose.cells_foss import Workbook

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

Aceasta păstrează toate valorile celulelor și structura de bază. Notă: Exportul Markdown citește doar cell.value — celulele care conțin doar o formulă fără valoare în cache vor apărea goale în rezultat. Biblioteca nu evaluează formulele în timpul exportului. Pentru a vă asigura că rezultatele formulelor apar, deschideți fișierul în Excel sau LibreOffice mai întâi (care evaluează și stochează în cache rezultatele formulelor), salvați ca XLSX, apoi reexportați.

Pasul 7: Gestionarea erorilor

Încapsulați exporturile în blocuri try/except pentru utilizare în producție:

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

Probleme comune și soluții

1. Ieșire Markdown goală

Cause: Foaia de calcul nu are celule populate.
Fix: Confirmați că ws.cells["A1"].value este setat și nu None înainte de a apela save_as_markdown().

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

Cause: Pachetul nu este instalat sau a fost folosit un nume de pachet greșit.
Fix: Rulați pip install aspose-cells-foss. Importul este from aspose.cells_foss import ... (underscore, nu punct).

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

Cauză: Ați instalat pachetul greșit (aspose-cells-python în loc de aspose-cells-foss).
Remediere: pip install aspose-cells-foss și confirmați from aspose.cells_foss import Workbook.

4. Probleme de codare în fișierul de ieșire

Cauză: Scrierea șirului Markdown într-un fișier fără a specifica codarea UTF-8.
Remediere: Folosiți MarkdownHandler.save_markdown_to_string() și scrieți explicit:

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

Întrebări frecvente

Pot exporta în PDF în schimb?

Nu. Exportul PDF nu este disponibil în Aspose.Cells FOSS. Utilizaţi pachetul comercial aspose-cells-python pentru ieşire PDF.

Ce formate de intrare pot încărca și apoi exporta în Markdown?

Fișierele XLSX și CSV pot fi încărcate cu Workbook("file.xlsx") și apoi exportate în Markdown.

Cum pot exporta doar o singură foaie când există mai multe foi?

Implicit, save_as_markdown() exportă prima foaie de lucru. Transmite o instanță MarkdownSaveOptions pentru configurare suplimentară.

Pot să rulez asta pe Linux sau macOS?

Da. Biblioteca rulează pe Windows, Linux și macOS fără nicio configurare specifică platformei.

Resurse conexe:

 Română