Aspose.Cells FOSS
Python
Wie man Excel in Python zu Markdown exportiert

Wie man Excel in Python zu Markdown exportiert

Die Exportdaten von Excel in Markdown sind eine übliche Anforderung für Dokumentationspipelines, README-Generatoren und statische Arbeitsflüsse. Aspose.Cells FOSS for Python Die Verarbeitung der Daten über die workbook.save_as_markdown(): keine Microsoft Office-Anwendung erforderlich.

Anmerkung:: Aspose.Cells FOSS exportiert in XLSX, CSV, TSV und JSON. PDF-Export ist nicht Teil der Foss Bibliothek.

Warum Excel mit Aspose.Cells FOSS in Markdown exportieren?

  1. Keine Abhängigkeit vom Amt: Konvertiert vollständig in Python ohne native COM- oder Office-Installation.
  2. In-Memory-Unterstützung: Erstellen von Markdown-Strings ohne Datenein/Ausgang über die Verwendung MarkdownHandler.
  3. Anpassbarer Ausgang: Exportverhalten konfigurieren über: MarkdownSaveOptions.
  4. Rohrleitungsfreundlich: Integrieren Sie direkt in Dokumentationsgeneratoren, statische Hugo-Seiten oder GitHub Actions Workflows.

Schritt für Schritte

Schritt 1: Installieren Sie Aspose.Cells FOSS für Python

Installieren Sie die Bibliothek von PyPI mit pip:

pip install aspose-cells-foss

Die Installation überprüfen:

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

Schritt 2: Erstellen Sie ein Arbeitsbuch und füllen Sie die Daten aus 

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

Schritt 3: Export auf Markdown

Rufen Sie an . workbook.save_as_markdown() mit einem .md Ausgangsweg:

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

Die Ausgabe ist eine Standard-Markdown-Tabelle:

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

Schritt 4: Anpassung mit MarkdownSaveOptions

Verwendung MarkdownSaveOptions Um das Ausgangsformat zu steuern:

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)

Pass ein MarkdownSaveOptions In diesem Fall save_as_markdown() für die Konfiguration.

Schritt 5: Erstellen von Markdown-In-Memory (keine Datei E/A)

Verwendung MarkdownHandler.save_markdown_to_string() um den Markdown als Python-Zeichen zu erhalten:

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.

Schritt 6: Laden Sie ein vorhandenes XLSX und exportieren Sie es in Markdown 

from aspose.cells_foss import Workbook

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

Dies bewahrt alle Zellwerte und die Grundstruktur. Anmerkung: Marken für die Ausfuhren cell.value Die Bibliothek bewertet die Formeln nicht zum Zeitpunkt des Exports. Um sicherzustellen, dass die Ergebnisse der Formulieren angezeigt werden, öffnen Sie zuerst die Datei in Excel oder LibreOffice (die die Resultate der Formeln evaluiert und im Cache speichert), speisen Sie als XLSX und exportieren Sie dann erneut.

Schritt 7: Fehlerbearbeitung

Exporte in Versuchs-/Blockverpackungen mit Ausnahme von Blockverpacken für die Herstellung:

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

Häufige Probleme und Lösungen

1. Empty Markdown output

Ursache:Das Arbeitsblatt hat keine ausgefüllten Zellen. Behebung: Bestätigen ws.cells["A1"].value ist eingestellt und nicht None vor dem Anruf . save_as_markdown().

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

Ursache:Das Paket ist nicht installiert oder der falsche Pakenname wurde verwendet. Behebung:Laufen . pip install aspose-cells-foss.Die Einfuhr ist: from aspose.cells_foss import ... (Unterstrich, nicht Punkt).

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

Ursache:Sie haben das falsche Paket installiert (aspose-cells-python statt der aspose-cells-foss). Behebung: pip install aspose-cells-foss und bestätigen from aspose.cells_foss import Workbook.

4. Encoding issues in output file

Ursache: Das Schreiben der Markdown-Zeichenfolge in eine Datei ohne Angabe von UTF-8-Codierung. Behebung:Verwendung: MarkdownHandler.save_markdown_to_string() und schreiben Sie ausdrücklich:

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

Häufig gestellte Fragen

Kann ich stattdessen in PDF exportieren?

Nein. PDF-Export ist nicht in Aspose.Cells FOSS verfügbar. Verwenden Sie die kommerzielle Version des Programms, um den Text zu verarbeiten und das Dokument auszufüllen. aspose-cells-python Paket für die Ausgabe von PDF.

Welche Eingabeformate kann ich laden und dann in Markdown exportieren?

XLSX und CSV-Dateien können mit Workbook("file.xlsx") und dann nach Markdown exportiert.

Wie kann ich nur ein Blatt exportieren, wenn es mehrere Blätter gibt?

Standardmäßig, save_as_markdown() Exportiert das erste Arbeitsblatt. MarkdownSaveOptions In diesem Fall ist die Anpassung der Verarbeitung zu erfolgen.

Kann ich das auf Linux oder MacOS ausführen?

Die Bibliothek läuft auf Windows, Linux und MacOS ohne platfumspezifisches Setup.

Verwandte Ressourcen:

 Deutsch