NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #898 most downloaded on PyPI
Utility tool for converting various files to Markdown
Last release 13 days ago
21 Sep 2026
Ships fairly regularly
a new release about every 6 weeks
Nearly every release is documented
notes for 11 of 11 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
26 releases · first in 2024
One column per month.
This release rolls up dozens of small patches and bug fixes. For typical inputs and use cases, we expect outputs and behavior to remain largely unchan
This release rolls up dozens of small patches and bug fixes. For typical inputs and use cases, we expect outputs and behavior to remain largely unchanged from version 0.1.7.
The markitdown-ocr plugin has also been refactored to simplify future maintenance.
Note truncated.
Pin GitHub Actions to full-length commit SHAs by Dan Fiedler (@danfiedler-msft) in #2316
Note truncated.
This prerelease includes numerous small bug fixes. None adds new features or is expected to change output in typical cases. Nevertheless, the volume o
This prerelease includes numerous small bug fixes. None adds new features or is expected to change output in typical cases. Nevertheless, the volume of changes warrants a cautious rollout.
Please report any issues or regressions.
Full Changelog: v0.1.7...v0.1.8a1
fix: avoid O(n^2) value lookups in PPTX chart conversion by kz-000 in #2227
Full Changelog: v0.1.6...v0.1.7
Full Changelog: https://github.com/microsoft/markitdown/compare/v0.1.6...v0.1.7
[MS] Add OCR layer service for embedded images and PDF scans by @lesyk in https://github.com/microsoft/markitdown/pull/1541
Full Changelog: https://github.com/microsoft/markitdown/compare/v0.1.5...v0.1.6
Full Changelog: v0.1.5...v0.1.6
Update PDF table extraction to support aligned Markdown by lesyk in #1499
Full Changelog: v0.1.4...v0.1.5
Update PDF table extraction to support aligned Markdown by @lesyk in https://github.com/microsoft/markitdown/pull/1499
Full Changelog: https://github.com/microsoft/markitdown/compare/v0.1.4...v0.1.5b1
Full Changelog: v0.1.4...v0.1.5b1
Bumps mammoth to 1.11.0 to address cve-2025-11849 And pdfminer.six to 20251107 to address GHSA-wf5f-4jwr-ppcp
Maintenance release:
Bumps mammoth to 1.11.0 to address cve-2025-11849 And pdfminer.six to 20251107 to address GHSA-wf5f-4jwr-ppcp
Pin onnxruntime on Windows by Tomasz Kalinowski (@t-kalinowski) in #1274
onnxruntime on Windows by Tomasz Kalinowski (@t-kalinowski) in #1274Full Changelog: v0.1.2...v0.1.3
feat: render math equations in .docx documents by Sathindu (@sathinduga) in #1160
Sathindu (@sathinduga) made their first contribution in #1160
Turdıbek (@erinshek) made their first contribution in #1176
lentil32 (@lentil32) made their first contribution in #1175
wip (@createcentury) made their first contribution in #1187
kira-offgrid made their first contribution in #1251
t3tra (@t3tra-dev) made their first contribution in #1256
JoshClark-git made their first contribution in #1241
Yi-Cheng Wang (@kirisame-wang) made their first contribution in #1253
一I (@Wuhall) made their first contribution in #1249
Betula-L made their first contribution in #1245
rtpacks (@rtpacks) made their first contribution in #1201
Full Changelog: v0.1.1...v0.1.2
Updated packages/markitdown/src/markitdown/converter_utils/docx/math/omml.py to fix security vulnerability [python.lang.security.use-defused-xml-parse…
Full Changelog: v0.1.1...v0.1.2a1
convert_url renamed to convert_uri , and now handles data and file URIs by afourney in #1153
convert_url renamed to convert_uri, and now handles data and file URIs by afourney in #1153
NOTE: convert_url remains an alias to convert_uri, for backward compatibility.
Both now accept file URIs and data URIs:
e.g.,
markitdown = MarkItDown()
result = markitdown.convert_uri("file:///path/to/file.txt")
print(result.markdown)And,
markitdown = MarkItDown()
result = markitdown.convert_uri("data:text/plain;base64,SGVsbG8sIFdvcmxkIQ==")
print(result.markdown)Full Changelog: v0.1.0...v0.1.1
…binary mode, or an io.BytesIO object). This is a breaking change from the previous version, which also accepted text file-like objects, like io.String…
Version 0.1.0 (previously 0.1.0a6) is a large release, bringing many improvements over the previous 0.0.2 version.
High-level changes include:
pip install markitdown[all]Use pip install markitdown[all] for backward-compatible behavior.convert_stream() now requires a binary file-like object (e.g., a file opened in binary mode, or an io.BytesIO object). This is a breaking change from the previous version, which also accepted text file-like objects, like io.StringIO.DocumentConverter class interface has changed to read from file-like streams rather than file paths. No temporary files are created anymore. If you are the maintainer of a plugin or custom DocumentConverter, you likely need to update your code. Otherwise, if you're only using the MarkItDown class or CLI (as in these examples), you should not need to change anything.Full Changelog: v0.0.2...v0.1.0
Add support for preserving base64 encoded images by @BetterAndBetterII in https://github.com/microsoft/markitdown/pull/1140
Full Changelog: https://github.com/microsoft/markitdown/compare/v0.1.0a5...v0.1.0a6
Consider anything with a charset as plain text-convertible. by @afourney in https://github.com/microsoft/markitdown/pull/1142
Full Changelog: https://github.com/microsoft/markitdown/compare/v0.1.0a4...v0.1.0a5
Basic EPub support from @0xRaduan, in collaboration with @afourney
Full Changelog: https://github.com/microsoft/markitdown/compare/v0.1.0a1...v0.1.0a4
Nothing published for this version
Nothing published for this version
This MarkItDown _alpha_ introduces numerous bug-fixes, and the following major changes:
This MarkItDown alpha introduces numerous bug-fixes, and the following major changes:
markitdown[all] to have backward-compatible behavior.Removes deprecated features from 0.0.1aX (pre-release alphas) by @afourney in https://github.com/microsoft/markitdown/pull/1105
Full Changelog: https://github.com/microsoft/markitdown/compare/v0.0.1...v0.0.2
Promoting v0.0.1a5 to a full release.
Promoting v0.0.1a5 to a full release.
For more details see the prior Release Notes.
Fixed compatibility with markdownify v1.0.0
Full Changelog: https://github.com/microsoft/markitdown/compare/v0.0.1a4...v0.0.1a5
feat: Add RSSConverter by @Soulter in https://github.com/microsoft/markitdown/pull/97
Full Changelog: https://github.com/microsoft/markitdown/compare/v0.0.1a3...v0.0.1a4
Renamed mlm_client and mlm_model arguments to llm_client and llm_model, and added appropriate deprecation warnings.
Renamed mlm_client and mlm_model arguments to llm_client and llm_model, and added appropriate deprecation warnings.
See:
Full Changelog: https://github.com/microsoft/markitdown/compare/v0.0.1a2...v0.0.1a3
The MarkItDown library is a utility tool for converting various files to Markdown (e.g., for indexing, text analysis, etc.)
The MarkItDown library is a utility tool for converting various files to Markdown (e.g., for indexing, text analysis, etc.)
It presently supports:
The API is simple:
from markitdown import MarkItDown
markitdown = MarkItDown()
result = markitdown.convert("test.xlsx")
print(result.text_content)
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →