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

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

Σημείωση: Οι μορφές εκκίνησης που υποστηρίζονται είναι XLSX, CSV, TSV, Markdown και JSON. aspose-cells-python απαιτείται για πρόσθετους στόχους εξαγωγής.

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

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

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

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

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

pip install aspose-cells-foss

Ελέγξτε την εγκατάσταση με εισαγωγή Workbook και να εκτυπώσει ένα μήνυμα επιβεβαίωσης:

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

Βήμα 2: Δημιουργία βιβλίου εργασίας και δημοφιλή δεδομένα

Δημιουργία ενός νέου Workbook, να έχετε πρόσβαση στο πρώτο φύλλο εργασίας και να γράψετε τίτλους και τιμές δεδομένων στα κύτταρα:

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() Με το A .md Ο δρόμος εξόδου για να γράψετε το πληθυσμένο φύλλο εργασίας ως αρχείο πίνακα Markdown:

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 και το παραδέχεται ως δεύτερο επιχείρημα για την save_as_markdown() Για να ελέγξετε τη μορφή εξόδου:

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)

Πάρτε το A MarkdownSaveOptions Η περίπτωση για save_as_markdown() Για τη διαμόρφωση.

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

Χρησιμοποιήστε MarkdownHandler.save_markdown_to_string() Για να πάρετε το Markdown ως Python string:

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

Κατεβάστε ένα υπάρχον εργαστήριο XLSX, περνώντας το δρόμο του προς την Workbook(),Στη συνέχεια καλέστε save_as_markdown() Για να το μετατρέψουμε:

from aspose.cells_foss import Workbook

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

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

Βήμα 7: Λάθος χειρισμού

Βάλτε την κλήση εξαγωγής σε ένα μπλοκ δοκιμής/εκτός για να χειριστείτε τα λείψατα αρχεία εισόδου και άλλα σφάλματα του χρόνου εκτέλεσης στον κωδικό παραγωγής:

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. Empty Markdown output

Αιτία:Το φύλλο εργασίας δεν έχει πληθυσμένα κύτταρα. ΦΙΛΕΞΗ:• Επιβεβαιώστε 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. Encoding issues in output file

Αιτία:Γράψτε την στήλη Markdown σε ένα αρχείο χωρίς να καθορίσετε τον κωδικοποιητή UTF-8. ΦΙΛΕΞΗ:• Χρησιμοποιήστε MarkdownHandler.save_markdown_to_string() για να πάρετε μια γραμμή Python, στη συνέχεια γράψτε το στο δίσκο με σαφήνεια utf-8 Κωδικοποίηση :

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

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

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

Το PDF-outs πέφτει εκτός του πεδίου εφαρμογής της έκδοσης FOSS. aspose-cells-python Εισαγωγή σε PDF.

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

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

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

Με παραδοσιακό τρόπο, save_as_markdown() Πρώτη εργασία για την εκτέλεση του προγράμματος.Παραβείτε το MarkdownSaveOptions Για παράδειγμα, για πρόσθετη διαμόρφωση.

Μπορώ να το κάνω αυτό στο Linux ή macOS;?

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

Σχετικά με τους πόρους:

Aspose.Cells FOSS for Python: Developer Guide
Εξαγωγικές μορφές
Ξεκινά / εγκαταστήστε
Πυροβολισμοί αναφοράς: MarkdownHandler, MarkdownSaveOptions, Workbook.save_as_markdown()
Γνώση βάσης: Περισσότερα πώς να οδηγούν (διαγράμματα, στυλ, φόρτιση)
ΕΠΙΣΚΕΨΗ ΠΡΟΤΑΣΙΑΣ: Χαρακτηριστικά και δυνατότητες σύνοψη
Blog: Εισαγωγή Aspose.Cells FOSS:Βιβλιοθήκη και γρήγορη έναρξη

Δείτε επίσης

Aspose.Cells for Python — Enterprise Knowledge Base