Aspose.Cells FOSS
Python
Πώς να εξάγετε το Excel σε Markdown με Python

Πώς να εξάγετε το Excel σε Markdown με Python

Η εξαγωγή δεδομένων Excel σε Markdown είναι μια κοινή απαίτηση για τις γραμμές εργασίας τεκμηρίωσης, τους δημιουργούς README και τις ροές εργασίας στατικών ιστοτόπων. Aspose.Cells FOSS for Python το καθιστά μια λειτουργία με μία μόνο μέθοδο μέσω workbook.save_as_markdown(): δεν απαιτείται Microsoft Office.

Σημείωση: Aspose.Cells FOSS εξάγει σε XLSX, CSV, TSV, Markdown και JSON. Η εξαγωγή σε PDF δεν αποτελεί μέρος της βιβλιοθήκης FOSS.

Γιατί να εξάγετε το Excel σε Markdown με το Aspose.Cells FOSS?

  1. Χωρίς εξάρτηση από το Office: Μετατρέπει εξ ολοκλήρου σε Python χωρίς εγγενή COM ή εγκατάσταση του Office.
  2. Υποστήριξη εντός μνήμης: Δημιουργήστε συμβολοσειρές Markdown χωρίς καμία εισ/εξ έξοδο δίσκου χρησιμοποιώντας MarkdownHandler.
  3. Προσαρμόσιμο αποτέλεσμα: Διαμορφώστε τη συμπεριφορά εξαγωγής μέσω MarkdownSaveOptions.
  4. Φιλικό προς τις γραμμές επεξεργασίας: Ενσωματώστε απευθείας σε γεννήτριες τεκμηρίωσης, στατικούς ιστότοπους Hugo ή ροές εργασίας GitHub Actions.

Οδηγός βήμα προς βήμα

Βήμα 1: Εγκατάσταση Aspose.Cells FOSS για Python

Εγκαταστήστε τη βιβλιοθήκη από το PyPI χρησιμοποιώντας το pip:

pip install aspose-cells-foss

Επαληθεύστε την εγκατάσταση:

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

Βήμα 2: Δημιουργία Φύλλου Εργασίας και Συμπλήρωση Δεδομένων 

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

Βήμα 3: Εξαγωγή σε Markdown

Καλέστε workbook.save_as_markdown() με μια .md διαδρομή εξόδου:

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

Η έξοδος είναι ένας τυπικός πίνακας Markdown:

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

Βήμα 4: Προσαρμογή με MarkdownSaveOptions

Χρησιμοποιήστε MarkdownSaveOptions για να ελέγξετε τη μορφή εξόδου:

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)

Περάστε ένα MarkdownSaveOptions instance στο save_as_markdown() για διαμόρφωση.

Βήμα 5: Δημιουργία Markdown στη μνήμη (χωρίς I/O αρχείων)

Χρησιμοποιήστε MarkdownHandler.save_markdown_to_string() για να λάβετε το Markdown ως συμβολοσειρά 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.

Βήμα 6: Φόρτωση υπάρχοντος XLSX και εξαγωγή σε Markdown 

from aspose.cells_foss import Workbook

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

Αυτό διατηρεί όλες τις τιμές των κελιών και τη βασική δομή. Σημείωση: Η εξαγωγή σε Markdown διαβάζει μόνο cell.value — τα κελιά που περιέχουν μόνο έναν τύπο χωρίς αποθηκευμένη τιμή θα εμφανιστούν κενά στην έξοδο. Η βιβλιοθήκη δεν αξιολογεί τύπους κατά τη στιγμή της εξαγωγής. Για να εξασφαλιστεί ότι τα αποτελέσματα των τύπων εμφανίζονται, ανοίξτε το αρχείο πρώτα στο Excel ή στο LibreOffice (που αξιολογεί και αποθηκεύει τα αποτελέσματα των τύπων), αποθηκεύστε το ως XLSX, και στη συνέχεια εξάγετε ξανά.

Βήμα 7: Διαχείριση Σφαλμάτων

Τυλίξτε τις εξαγωγές σε μπλοκ try/except για χρήση σε παραγωγή:

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. Κενή έξοδος Markdown

Αιτία: Το φύλλο εργασίας δεν έχει γεμιστά κελιά.
Διόρθωση: Επιβεβαιώστε ότι το ws.cells["A1"].value είναι ορισμένο και όχι None πριν καλέσετε το save_as_markdown().

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

Αιτία: Το πακέτο δεν είναι εγκατεστημένο ή χρησιμοποιήθηκε λανθασμένο όνομα πακέτου.
Διόρθωση: Εκτελέστε pip install aspose-cells-foss. Η εισαγωγή είναι from aspose.cells_foss import ... (υπογράμμιση, όχι τελεία).

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

Αιτία: Έχετε εγκαταστήσει το λάθος πακέτο (aspose-cells-python αντί για aspose-cells-foss).
Διόρθωση: pip install aspose-cells-foss και επιβεβαιώστε from aspose.cells_foss import Workbook.

4. Προβλήματα κωδικοποίησης στο αρχείο εξόδου

Αιτία: Γράψιμο της συμβολοσειράς Markdown σε αρχείο χωρίς να καθοριστεί κωδικοποίηση UTF-8.
Διόρθωση: Χρησιμοποιήστε MarkdownHandler.save_markdown_to_string() και γράψτε ρητά:

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

Συχνές Ερωτήσεις

Μπορώ να εξάγω σε PDF αντί για αυτό;

Όχι. Η εξαγωγή PDF δεν είναι διαθέσιμη στο Aspose.Cells FOSS. Χρησιμοποιήστε το εμπορικό aspose-cells-python πακέτο για έξοδο PDF.

Ποιοι τύποι εισόδου μπορώ να φορτώσω και στη συνέχεια να εξάγω σε Markdown;

Τα αρχεία XLSX και CSV μπορούν να φορτωθούν με Workbook("file.xlsx") και στη συνέχεια να εξαχθούν σε Markdown.

Πώς μπορώ να εξάγω μόνο ένα φύλλο όταν υπάρχουν πολλαπλά φύλλα;

Από προεπιλογή, το save_as_markdown() εξάγει το πρώτο φύλλο εργασίας. Περνάτε μια παρουσία MarkdownSaveOptions για πρόσθετη διαμόρφωση.

Μπορώ να το εκτελέσω σε Linux ή macOS;

Ναι. Η βιβλιοθήκη λειτουργεί σε Windows, Linux, και macOS χωρίς καμία ειδική ρύθμιση πλατφόρμας.

Σχετικοί Πόροι:

 Ελληνικά