Aspose.Cells FOSS
Python
Come esportare Excel in Markdown con Python

Come esportare Excel in Markdown con Python

Esportare i dati di Excel in Markdown è una necessità comune per le pipeline di documentazione, i generatori di README e i flussi di lavoro di siti statici. Aspose.Cells FOSS for Python rende questa operazione a metodo unico tramite workbook.save_as_markdown(): non è necessario Microsoft Office.

Nota: Aspose.Cells FOSS esporta in XLSX, CSV, TSV, Markdown e JSON. L’esportazione in PDF non fa parte della libreria FOSS.

Perché esportare Excel in Markdown con Aspose.Cells FOSS?

  1. Nessuna dipendenza da Office: Converte interamente in Python senza COM nativo o installazione di Office.
  2. Supporto in memoria: Genera stringhe Markdown senza alcuna I/O su disco usando MarkdownHandler.
  3. Output personalizzabile: Configura il comportamento di esportazione tramite MarkdownSaveOptions.
  4. Compatibile con pipeline: Integralo direttamente nei generatori di documentazione, siti statici Hugo o flussi di lavoro di GitHub Actions.

Guida passo passo

Passo 1: Installa Aspose.Cells FOSS per Python

Installa la libreria da PyPI usando pip:

pip install aspose-cells-foss

Verifica l’installazione:

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

Passo 2: Crea un Workbook e Popola i Dati 

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

Passo 3: Esporta in Markdown

Chiama workbook.save_as_markdown() con un percorso di output .md:

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

L’output è una tabella Markdown standard:

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

Passo 4: Personalizza con MarkdownSaveOptions

Usa MarkdownSaveOptions per controllare il formato di output:

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)

Passa un’istanza MarkdownSaveOptions a save_as_markdown() per la configurazione.

Passo 5: Genera Markdown in memoria (senza I/O di file)

Usa MarkdownHandler.save_markdown_to_string() per ottenere il Markdown come stringa 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.

Passo 6: Carica un XLSX esistente ed esporta in Markdown 

from aspose.cells_foss import Workbook

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

Questo preserva tutti i valori delle celle e la struttura di base. Nota: L’esportazione Markdown legge solo cell.value — le celle che contengono solo una formula senza valore memorizzato appariranno vuote nell’output. La libreria non valuta le formule al momento dell’esportazione. Per garantire che i risultati delle formule compaiano, apri prima il file in Excel o LibreOffice (che valuta e memorizza i risultati delle formule), salvalo come XLSX, quindi riesporta.

Passo 7: Gestione degli errori

Avvolgi le esportazioni in blocchi try/except per l’uso in produzione:

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

Problemi comuni e soluzioni

1. Output Markdown vuoto

Cause: Il foglio di lavoro non ha celle popolate.
Fix: Confermare che ws.cells["A1"].value è impostato e non None prima di chiamare save_as_markdown().

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

Cause: Il pacchetto non è installato o è stato usato un nome di pacchetto errato.
Fix: Esegui pip install aspose-cells-foss. L’import è from aspose.cells_foss import ... (underscore, non punto).

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

Cause: Hai installato il pacchetto sbagliato (aspose-cells-python invece di aspose-cells-foss).
Fix: pip install aspose-cells-foss e conferma from aspose.cells_foss import Workbook.

4. Problemi di codifica nel file di output

Causa: Scrivere la stringa Markdown in un file senza specificare la codifica UTF‑8.
Correzione: Usare MarkdownHandler.save_markdown_to_string() e scrivere esplicitamente:

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

Domande Frequenti

Posso esportare in PDF invece?

No. L’esportazione PDF non è disponibile in Aspose.Cells FOSS. Utilizza il pacchetto commerciale aspose-cells-python per l’output PDF.

Quali formati di input posso caricare e poi esportare in Markdown?

I file XLSX e CSV possono essere caricati con Workbook("file.xlsx") e poi esportati in Markdown.

Come faccio a esportare solo un foglio quando ci sono più fogli?

Per impostazione predefinita, save_as_markdown() esporta il primo foglio di lavoro. Passa un’istanza MarkdownSaveOptions per una configurazione aggiuntiva.

Posso eseguirlo su Linux o macOS?

Sì. La libreria funziona su Windows, Linux e macOS senza alcuna configurazione specifica per la piattaforma.

Risorse correlate:

 Italiano