openize-markitdown-python 25.4.0

A document converter for Word, PDF, Excel, and PowerPoint to Markdown.

Openize.MarkItDown for Python

Openize.MarkItDown for Python converts documents into Markdown format. It supports multiple file formats, provides flexible output handling, and integrates with LLMs for extended processing.

Features

• Convert .docx, .pdf, .xlsx, and .pptx to Markdown.
• Save Markdown files locally or send them to an LLM for processing.
• Structured with the Factory & Strategy Pattern for scalability.
• Works with Windows and Linux-compatible paths.
• Command-line interface for easy use.

Requirements

This package depends on the Aspose libraries, which are commercial products:

• Aspose.Words
• Aspose.Cells
• Aspose.Slides

You'll need to obtain valid licenses for these libraries separately. The package will install these dependencies, but you're responsible for complying with Aspose's licensing terms.

Installation

From TestPyPI

pip install openize-markitdown-python

Usage

Command Line Interface

# Convert a file and save locally
markitdown document.docx -o output_folder

# Process with an LLM (requires OPENAI_API_KEY environment variable)
markitdown document.docx -o output_folder --insert_into_llm

Python API

from openize.markitdown.core import MarkItDown

# Define input file and output directory
input_file = "report.pdf"
output_dir = "output_markdown"

# Create MarkItDown instance
converter = MarkItDown(output_dir)

# Convert document and send output to LLM
converter.convert_document(input_file, insert_into_llm=True)

print("Conversion completed and data sent to LLM.")

Environment Variables

• ASPOSE_LICENSE_PATH: Required when using the Aspose Paid APIs. This should be set to the full path of your Aspose license file.
• OPENAI_API_KEY: Required when using the insert_into_llm=True option or the --llm flag.
• OPENAI_MODEL: Specifies the OpenAI model name (default: gpt-4).

To set these variables:

For Unix-based systems:

export ASPOSE_LICENSE_PATH="/path/to/license"
export OPENAI_API_KEY="your-api-key"
export OPENAI_MODEL="gpt-4"

For Windows (PowerShell):

$env:ASPOSE_LICENSE_PATH = "C:\path\to\license"
$env:OPENAI_API_KEY = "your-api-key"
$env:OPENAI_MODEL = "gpt-4"

License

This package is licensed under the MIT License. However, it depends on Aspose libraries, which are proprietary, closed-source libraries.

⚠️ Users must obtain a valid license for Aspose libraries separately. This repository does not include or distribute any proprietary components.