Python में Excel को Markdown में निर्यात कैसे करें

Python में Excel को Markdown में निर्यात कैसे करें

Excel डेटा को Markdown में निर्यात करना दस्तावेज़ीकरण पाइपलाइन, README जेनरेटर और स्थैतिक साइट वर्कफ़्लो के लिए एक सामान्य आवश्यकता है। Aspose.Cells FOSS for Python इसे एकल‑मेथड ऑपरेशन बनाता है workbook.save_as_markdown() के माध्यम से: कोई Microsoft Office आवश्यक नहीं।

नोट: Aspose.Cells FOSS XLSX, CSV, TSV, Markdown, और JSON में निर्यात करता है। PDF निर्यात FOSS लाइब्रेरी का हिस्सा नहीं है।

Aspose.Cells FOSS के साथ Excel को Markdown में क्यों निर्यात करें?

  1. कोई Office निर्भरता नहीं: Python में पूरी तरह से परिवर्तित करता है, बिना किसी मूल COM या Office स्थापना के।
  2. इन‑मेमोरी समर्थन: MarkdownHandler का उपयोग करके किसी भी डिस्क I/O के बिना Markdown स्ट्रिंग्स उत्पन्न करें।
  3. अनुकूलन योग्य आउटपुट: MarkdownSaveOptions के माध्यम से निर्यात व्यवहार को कॉन्फ़िगर करें।
  4. पाइपलाइन‑फ्रेंडली: डॉक्यूमेंटेशन जेनरेटर, Hugo स्थैतिक साइट्स, या GitHub Actions वर्कफ़्लो में सीधे एकीकृत करें।

चरण-दर-चरण मार्गदर्शिका

चरण 1: Aspose.Cells FOSS को Python के लिए स्थापित करें

pip का उपयोग करके PyPI से लाइब्रेरी स्थापित करें:

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: मार्कडाउन में निर्यात करें

workbook.save_as_markdown() को एक .md आउटपुट पथ के साथ कॉल करें:

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

आउटपुट एक मानक मार्कडाउन तालिका है:

| 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 इंस्टेंस को save_as_markdown() को पास करें।


चरण 5: इन‑मेमोरी में मार्कडाउन उत्पन्न करें (कोई फ़ाइल 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 लोड करें और मार्कडाउन में निर्यात करें

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. खाली मार्कडाउन आउटपुट

Cause: वर्कशीट में कोई पॉपुलेटेड सेल नहीं हैं.
Fix: save_as_markdown() को कॉल करने से पहले पुष्टि करें कि ws.cells["A1"].value सेट है और None नहीं है.

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. आउटपुट फ़ाइल में एन्कोडिंग समस्याएँ

कारण: 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 में उपलब्ध नहीं है। PDF आउटपुट के लिए वाणिज्यिक aspose-cells-python पैकेज का उपयोग करें।

मैं कौन से इनपुट फ़ॉर्मेट लोड कर सकता हूँ और फिर उन्हें मार्कडाउन में निर्यात कर सकता हूँ?

XLSX और CSV फ़ाइलों को Workbook("file.xlsx") के साथ लोड किया जा सकता है और फिर उन्हें Markdown में निर्यात किया जा सकता है।

जब कई शीट्स हों, तो केवल एक शीट को कैसे निर्यात करूँ?

डिफ़ॉल्ट रूप से, save_as_markdown() पहली कार्यपत्रक को निर्यात करता है। अतिरिक्त कॉन्फ़िगरेशन के लिए एक MarkdownSaveOptions इंस्टेंस पास करें।

क्या मैं इसे Linux या macOS पर चला सकता हूँ?

हाँ। लाइब्रेरी Windows, Linux और macOS पर किसी भी प्लेटफ़ॉर्म‑विशिष्ट सेटअप के बिना चलती है।


संबंधित संसाधन:

 हिन्दी