Aspose.Cells FOSS
Python
Sådan eksporterer du Excel til Markdown i Python

Sådan eksporterer du Excel til Markdown i Python

Eksport af Excel-data til Markdown er et almindeligt krav for dokumentations‑pipelines, README‑generatorer og statiske web‑workflows. Aspose.Cells FOSS for Python gør dette til en enkelt‑metode‑operation via workbook.save_as_markdown(): ingen Microsoft Office påkrævet.

Bemærk: Aspose.Cells FOSS eksporterer til XLSX, CSV, TSV, Markdown og JSON. PDF-eksport er ikke en del af FOSS-biblioteket.

Hvorfor eksportere Excel til Markdown med Aspose.Cells FOSS?

  1. Ingen Office-afhængighed: Konverterer fuldstændigt i Python uden native COM eller Office-installation.
  2. Understøttelse i hukommelsen: Generer Markdown-strenge uden nogen disk‑I/O ved brug af MarkdownHandler.
  3. Tilpasningsoutput: Konfigurer eksportadfærd via MarkdownSaveOptions.
  4. Pipeline-venlig: Integrer direkte i dokumentationsgeneratorer, Hugo statiske sites eller GitHub Actions‑arbejdsgange.

Trin-for-trin guide

Trin 1: Installer Aspose.Cells FOSS for Python

Installer biblioteket fra PyPI ved hjælp af pip:

pip install aspose-cells-foss

Bekræft installationen:

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

Trin 2: Opret en projektmappe og udfyld data 

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

Trin 3: Eksporter til Markdown

Kald workbook.save_as_markdown() med en .md outputsti:

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

Outputtet er en standard Markdown‑tabel:

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

Trin 4: Tilpas med MarkdownSaveOptions

Brug MarkdownSaveOptions til at kontrollere outputformatet:

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)

Videregiv en MarkdownSaveOptions-instans til save_as_markdown() for konfiguration.

Trin 5: Generer Markdown i hukommelsen (ingen fil‑I/O)

Brug MarkdownHandler.save_markdown_to_string() for at få Markdown som en Python‑streng:

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.

Trin 6: Indlæs en eksisterende XLSX og eksporter til Markdown 

from aspose.cells_foss import Workbook

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

Dette bevarer alle celleværdier og grundlæggende struktur. Bemærk: Markdown‑eksport læser kun cell.value — celler, der kun indeholder en formel uden cachet værdi, vil fremstå tomme i outputtet. Biblioteket evaluerer ikke formler ved eksporttidspunktet. For at sikre, at formelresultater vises, skal du åbne filen i Excel eller LibreOffice først (som evaluerer og cachet formelresultater), gem som XLSX og derefter eksportere igen.

Trin 7: Fejlhåndtering

Pak eksporterne ind i try/except‑blokke til produktionsbrug:

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

Almindelige problemer og løsninger

1. Tom Markdown-uddata

Cause: Regnearket har ingen udfyldte celler.
Fix: Bekræft, at ws.cells["A1"].value er indstillet og ikke None, før du kalder save_as_markdown().

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

Årsag: Pakken er ikke installeret, eller det forkerte pakkenavn blev brugt.
Løsning: Kør pip install aspose-cells-foss. Importen er from aspose.cells_foss import ... (underscore, ikke punktum).

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

Årsag: Du installerede den forkerte pakke (aspose-cells-python i stedet for aspose-cells-foss).
Løsning: pip install aspose-cells-foss og bekræft from aspose.cells_foss import Workbook.

4. Kodningsproblemer i outputfil

Årsag: Skriver Markdown‑strengen til en fil uden at specificere UTF‑8‑kodning.
Løsning: Brug MarkdownHandler.save_markdown_to_string() og skriv eksplicit:

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

Ofte stillede spørgsmål

Kan jeg eksportere til PDF i stedet?

Nej. PDF‑eksport er ikke tilgængelig i Aspose.Cells FOSS. Brug den kommercielle aspose-cells-python‑pakke til PDF‑output.

Hvilke inputformater kan jeg indlæse og derefter eksportere til Markdown?

XLSX- og CSV-filer kan indlæses med Workbook("file.xlsx") og derefter eksporteres til Markdown.

Hvordan eksporterer jeg kun ét ark, når der er flere ark?

Som standard eksporterer save_as_markdown() det første regneark. Videregiv en MarkdownSaveOptions-instans for yderligere konfiguration.

Kan jeg køre dette på Linux eller macOS?

Ja. Biblioteket kører på Windows, Linux og macOS uden nogen platformspecifik opsætning.

Relaterede ressourcer:

 Dansk