Aspose.Cells FOSS
Python
كيفية تصدير Excel إلى Markdown في Python

كيفية تصدير Excel إلى Markdown في Python

تصدير بيانات Excel إلى Markdown هو متطلب شائع لقطاب الوثائق، ومولدات README، وتدفقات العمل الموقع الثابت. Aspose.Cells FOSS for Python هذا هو العملية الوحيدة من خلال workbook.save_as_markdown():لا يوجد مايكروسوفت Office مطلوب.

ملاحظة: Aspose.Cells تصدير FOSS إلى XLSX، CSV، TSV، Markdown، و JSON. PDF الصادرات ليست جزءا من مكتبة Foss.

لماذا تصدير Excel إلى Markdown مع Aspose.Cells FOSS؟?

  1. لا مكتب الإدمان: تحويل كاملا إلى Python مع لا تركيب COM أو Office الأصلي.
  2. دعم الذاكرة: توليد الشرائح Markdown دون أي قرص I/O باستخدام MarkdownHandler.
  3. تصنيع مخصص: إعداد سلوك التصدير من خلال MarkdownSaveOptions.
  4. طائرة صديقة: دمج مباشرة في مولدات الوثائق، مواقع Hugo الثابتة، أو تدفقات العمل GitHub الإجراءات.

خطوة بخطوة دليل

الخطوة 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

الخطوة الثالثة: التصدير إلى Markdown

مكالمة workbook.save_as_markdown() مع A .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 مثال على save_as_markdown() من أجل التكوين.

الخطوة 5: إنشاء Markdown In-Memory (لا ملف 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.")

هذا يحافظ على جميع القيم الخلوية والهيكل الأساسي. ملاحظة : قراءة مارك داون cell.value فقط - الخلايا التي تحتوي على صيغة واحدة فقط مع لا قيمة مخفية سوف تظهر فارغة في النتيجة.المكتبة لا تقييم الصيغ في وقت التصدير.لضمان أن نتائج الصوغة تظهرت، فتح الملف في Excel أو LibreOffice أولا (الذي يقيّم وتخفي نتائج صياغة)، باستثناء XLSX، ثم إعادة تصديرها.

الخطوة السابعة: إصلاح الأخطاء

تصدير الحفر في محاولة/باستثناء الكتل للاستخدام الإنتاجية:

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() وكتبوا بصراحة :

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

الأسئلة المتكررة

هل يمكنني تصديرها إلى PDF بدلاً من ذلك؟?

لا. PDF export غير متوفر في Aspose.Cells FOSS. aspose-cells-python حزمة إصدار PDF.

ما هي تنسيقات الإدخال التي يمكنني تحميلها ثم تصديرها إلى Markdown؟?

يمكن تحميل ملفات XLSX و CSV مع Workbook("file.xlsx") ثم تم تصديرها إلى ماركداون.

كيف يمكنني تصدير ورقة واحدة فقط عندما يكون هناك ورقات متعددة؟?

وبالنسبة للفرض،, save_as_markdown() أولاً: إرسال رسالة خاصة إلى A. MarkdownSaveOptions مثال آخر على إعدادات إضافية.

هل يمكنني تشغيل هذا على Linux أو macOS؟?

نعم، تعمل المكتبة على ويندوز، لينكس، و macOS دون أي إعدادات منصة محددة.

الموارد ذات الصلة :

 العربية