MarkItDown (without magika)

0.1.2 verified Sat May 09 auth: no python

A variant of the Microsoft MarkItDown library for converting various file formats (Office docs, images, PDFs, etc.) to Markdown, specifically without the magika dependency for file type detection. Current version 0.1.2, based on markitdown 0.1.2. Release cadence is irregular; the underlying markitdown has frequent updates.

pip install markitdown-no-magika

Common errors

error ModuleNotFoundError: No module named 'markitdown' ↓

cause The package is installed as 'markitdown-no-magika', but the import uses 'markitdown'. This error occurs if the underlying 'markitdown' package is not present.

fix

Run 'pip install markitdown-no-magika' which automatically installs 'markitdown' as a dependency.

error AttributeError: 'MarkItDown' object has no attribute 'convert_url' ↓

cause The method 'convert_url' was renamed to 'convert_uri' in v0.1.1. Using older code with newer library versions.

fix

Replace 'md.convert_url(...)' with 'md.convert_uri(...)'.

error ValueError: Could not convert file: unsupported file type ↓

cause Missing optional dependency for the file format (e.g., PDF, image). The base install of markitdown-no-magika does not include all converters.

fix

Install the required extra: 'pip install markitdown[pdf]' or 'pip install markitdown[all]'.

Warnings

gotcha The package name is 'markitdown-no-magika', but the import statement remains 'from markitdown import ...'. This can cause confusion if both markitdown and markitdown-no-magika are installed. ↓

fix Ensure only one variant is installed or use virtual environments.

deprecated The method 'convert_url' is deprecated in favor of 'convert_uri' since v0.1.1. It still works as an alias but may be removed in future. ↓

fix Use 'convert_uri' instead of 'convert_url'.

breaking Dependency organization changed in v0.1.0; optional converters (e.g., PDF, images) require installing extras like 'markitdown[pdf]' or 'markitdown[all]'. Without extras, some file types fail silently. ↓

fix Install needed extras: 'pip install markitdown[pdf]' or 'pip install markitdown[all]'.

gotcha The 'markitdown-no-magika' package pins 'markitdown' to exactly 0.1.2 and removes magika dependency. Upgrading markitdown independently breaks the install. ↓

fix Do not manually upgrade markitdown; rely on this package's version constraints.

Imports

MarkItDown
```
from markitdown import MarkItDown
```
Despite the package name 'markitdown-no-magika', the module is still 'markitdown'.

Quickstart

Convert a file to Markdown using the default converter.

from markitdown import MarkItDown
md = MarkItDown()
result = md.convert("example.docx")
print(result.markdown)