Analyzing your prompt, please hold on...
An error occurred while retrieving the results. Please refresh the page and try again.
Purpose Summary. What is this page about?
This page describes the Aspose.Words for MarkItDown plugin, including its features, installation steps, usage via CLI and Python API, licensing requirements, and how to run its tests.
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.
Aspose.Words for MarkItDown supports the following features:
.doc, .rtf, .odt, .mhtml, .mobi and .azw3 formats.docx, .pdf, .html, .epub and .txt documentsYou’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.
To install Aspose.Words for MarkItDown via pip, run the following:
pip install aspose-words-markitdown
markitdown --list-pluginsInstalled MarkItDown 3rd-party Plugins:
* aspose_words_markitdown (package: aspose_words_markitdown)
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
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) 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.
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.Python.NET.lic"
Windows-based:
set ASPOSE_WORDS_LICENSE_PATH=c:\path\to\license\Aspose.Words.Python.NET.lic
Python API:
from aspose_words_markitdown import LicenseManager
LicenseManager().apply_license("/path/to/license/Aspose.Words.Python.NET.lic") To run unit tests for Aspose.Words for MarkItDown, follow these steps:
cd /packages/aspose-words-markitdown/tests
pytest is installed:pip install pytest
pytest:pytest
Q: Can an Aspose.Total.NET license be used with the Aspose.Words for Python via .NET library?
A: No. A license issued for a .NET product (e.g., Aspose.Total.NET.lic) is not valid for Aspose.Words for Python via .NET. Use an Aspose.Words for Python via .NET license (Aspose.Words.Python.NET.lic) or an Aspose.Total for Python via .NET license (Aspose.Total.Python.NET.lic). Using a .NET license results in a “license is not valid for this product” error.
Q: How do I apply the Aspose.Words license when using the MarkItDown plugin in Python?
A: Set the environment variable ASPOSE_WORDS_LICENSE_PATH to the full path of your Aspose.Words.Python.NET.lic file, or call the helper class provided by the plugin:
from aspose_words_markitdown import LicenseManager
LicenseManager().apply_license("/full/path/to/Aspose.Words.Python.NET.lic")
This must be done before any conversion operation is executed.
Q: Why do I receive the error “RuntimeError: Proxy error(InvalidOperationException): The license is not valid for this product.”?
A: This error occurs when the license file was issued for another product, for example, a .NET license such as Aspose.Total.NET.lic. A modified or corrupted license file gives the “Invalid license signature” error instead, and a missing file gives “Cannot find license”. Verify that you are using a valid Aspose.Words for Python via .NET or Aspose.Total for Python via .NET license and that the path is correct.
Q: Does the MarkItDown plugin require a separate license from the Aspose.Words library?
A: No. The plugin itself is open‑source and distributed under the MIT license. It only depends on the commercial Aspose.Words for Python via .NET library, so you need a license only for that library, not for the plugin.
Q: How can I confirm that the plugin is correctly installed and recognized by MarkItDown?
A: Run markitdown --list-plugins. The output should contain a line similar to:
* aspose_words_markitdown (package: aspose_words_markitdown)
If the plugin appears in the list, it is installed correctly. You can also perform a quick conversion with markitdown sample.doc -o out.md --use-plugins and verify that the output file is generated without errors.
Analyzing your prompt, please hold on...
An error occurred while retrieving the results. Please refresh the page and try again.