Aspose.Words for MarkItDown plugin

Overview

Aspose.Words for MarkItDown is a free plugin for MarkItDown based on Aspose.Words for Python via .Net commercial library.
The plugin is designed for parsing multiple document formats and converting them into Markdown suitable for AI processing.
The project is located in the GitHub repository.

Features

Parsing new .doc, .rtf, .odt, .mhtml, .mobi and .azw3 formats.
Improved conversion of .docx, .pdf, .html, .epub and .txt documents.
Support all document components, including paragraphs, tables, images, headers, and footers.
Fully integrated with MarkItDown tool. You don’t need to change your code to use the Aspose.Words plugin.

Requirements

MarkItDown version 0.1.0 or higher.
Aspose.Words for Python via .Net. This library is a commercial product.
You’ll need to obtain valid license for Aspose.Words. The package will install this dependency, but you’re responsible for complying with Aspose’s licensing terms.

Installation

pip install aspose-words-markitdown

Usage

Make sure the plugin is installed correctly

List MarkItDown plugins with the command:

markitdown --list-plugins

Check the plugin is installed:

Installed MarkItDown 3rd-party Plugins:
  * aspose_words_markitdown  (package: aspose_words_markitdown)

Command Line Interface

You can use the original markitdown CLI in the common way. Just add the --use-plugins option to enable the plugin.

Convert a Single File

markitdown test.doc -o out.md --use-plugins

Python API

Basic usage in Python:

  
from markitdown import MarkItDown  

md = MarkItDown(enable_plugins=True) # Set to True to enable the plugin  
result = md.convert("test.doc")  
print(result.text_content)

Set License

Environment Variables

To activate your Aspose.Words for Python license, set the corresponding environment variable.
Refer to the OS-specific instructions below:

Unix-based (Linux/macOS):

export ASPOSE_WORDS_LICENSE_PATH="/path/to/license/aspose.words.lic"

Windows-based:

set ASPOSE_WORDS_LICENSE_PATH=c:\path\to\license\aspose.words.lic

Python API:

  
from aspose_words_markitdown import LicenseManager

LicenseManager().apply_license("/path/to/license/aspose.words.lic")

Running Tests

To run unit tests for Aspose.Words for MarkItDown, follow these steps:

1. Navigate to the package directory

From the root of the repository, change into the package directory:

cd /packages/aspose-words-markitdown/tests

2. Install test dependencies

Make sure pytest is installed:

pip install pytest

3. Run tests using `pytest`

To run all tests:

pytest

License

This package is licensed under the MIT License. However, it depends on Aspose.Words for Python via .Net library, which is proprietary, closed-source library.

⚠️ You must obtain valid license for Aspose.Words for Python via .Net library. This repository does not include or distribute any proprietary components.