Aspose.Cells FOSS
Python
Jak exportovat Excel do Markdown v Pythonu

Jak exportovat Excel do Markdown v Pythonu

Exportování dat z programu Excel do Markdown je běžným požadavkem pro dokumentační potrubí, generátory README a statické pracovní toky na webu. Aspose.Cells FOSS for Python činí z toho jednométou operaci prostřednictvím workbook.save_as_markdown(): není nutná žádná Microsoft Office.

Poznámka::Export FOSS do XLSX, CSV, TSV a JSON. PDF export není součástí knihovny Fossu.

Proč exportovat Excel do Markdownu pomocí Aspose.Cells FOSS?

  1. Žádná závislost na úřadu: Konvertuje se zcela do Pythonu bez nativní instalace COM nebo Office.
  2. Podpora v paměti: Vytvořit Markdown řetězce bez jakýchkoliv disku I / O pomocí MarkdownHandler.
  3. Vypravitelný výstup: Nastavení chování exportu prostřednictvím: MarkdownSaveOptions.
  4. Přívětivá k potrubím: Integrovat přímo do generátorů dokumentace, statických stránek Hugo nebo pracovních postupů GitHub Actions.

Krok za krokem

Krok 1: Nainstalujte Aspose.Cells FOSS pro Python

Nainstalovat knihovnu z PyPI pomocí pip:

pip install aspose-cells-foss

Ověřte instalaci:

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

Krok 2: Vytvořte pracovní knihu a doplňte údaje 

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

Krok 3: Export do Markdownu

Zavolej . workbook.save_as_markdown() s výjimkou: .md výstupní dráha:

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

Výstup je standardní Markdownová tabulka:

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

Krok 4: Přizpůsobit pomocí MarkdownSaveOptions

Použití: MarkdownSaveOptions ovládání výstupního formátu:

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)

Projít a. MarkdownSaveOptions Příklad: save_as_markdown() pro konfiguraci.

Krok 5: Vytvořit Markdown v paměti (bez souborů I/O)

Použití: MarkdownHandler.save_markdown_to_string() k získání Markdown jako Python stringy:

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.

Krok 6: Nahrát existující XLSX a exportovat do Markdownu 

from aspose.cells_foss import Workbook

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

To zachovává všechny hodnoty buněk a základní strukturu. Poznámka: Vývozní značka se čte: cell.value V výstupu se objeví prázdné pouze buňky , které obsahují jen vzorec bez ukládané hodnoty. Knihovna nevyhodnocuje vzorce v době exportu. Chcete-li zajistit zobrazení výsledků formulí, nejdříve otevřete soubor ve službě Excel nebo LibreOffice (který vyhodnocuje a ukládá do mezipaměti výsledky formul), uložte jako XLSX a pak znovu exportujte.

Krok 7: Zpracování chyb

Vývoz v obalu/s výjimkou bloků pro výrobní použití:

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

Obvyklé problémy a řešení

1. Empty Markdown output

Příčina:: Pracovní list nemá vyplněné buňky. Opravy:Potvrzení: ws.cells["A1"].value je nastaven a není None před voláním . save_as_markdown().

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

Příčina:: Balíček není nainstalován nebo byl použit nesprávný název balíku. Opravy:Utíkej . pip install aspose-cells-foss.Dovoz je: from aspose.cells_foss import ... (podtržení, ne bodka).

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

Příčina:: Nainstaloval jste špatný balíček (aspose-cells-python místo: aspose-cells-foss). Opravy: pip install aspose-cells-foss a potvrdit. from aspose.cells_foss import Workbook.

4. Encoding issues in output file

Příčina:: Psaní řetězce Markdown do souboru bez upřesnění kódování UTF-8. Opravy:Použití: MarkdownHandler.save_markdown_to_string() a píše se výslovně:

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

Časté otázky

Můžu exportovat na PDF místo toho?

Ne. PDF export není k dispozici v Aspose.Cells FOSS. Použijte obchodní aplikaci aspose-cells-python balíček pro výstup PDF.

Které vstupní formáty mohu načíst a exportovat do Markdownu?

XLSX a CSV soubory mohou být načteny s Workbook("file.xlsx") a pak je exportován do Markdownu.

Jak můžu exportovat jen jeden list, když je jich víc?

Předvoleně, save_as_markdown() Exportuje první pracovní list. MarkdownSaveOptions příklad pro další konfiguraci.

Můžu to spustit na Linuxu nebo MacOS?

Knihovna běží na Windows, Linuxu a MacOS bez jakéhokoli specifického nastavení.

Související zdroje:

 Čeština