# markitdown changelog

> Python tool for converting files and office documents to Markdown.

- Vendor: microsoft
- Category: Developer Tools
- Official site: https://github.com/microsoft/markitdown
- Tracked by: What's New (https://whatsnew.fyi/product/markitdown)
- Harvested from: GitHub (microsoft/markitdown)
- Entries below: 10 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

## Releases

### v0.1.6 — Version 0.1.6

- Date: 2026-05-26
- Version: v0.1.6
- Original notes: https://github.com/microsoft/markitdown/releases/tag/v0.1.6
- Permalink: https://whatsnew.fyi/product/markitdown/releases/v0.1.6

- **added** — Add OCR layer service for embedded images and PDF scans
- **fixed** — Fix O(n) memory growth in PDF conversion by calling page.close()
- **changed** — Update warning about binding to non-local interfaces
- **fixed** — Handle deeply nested HTML that triggers RecursionError
- **changed** — Clarify security posture in READMEs
- **added** — Add Azure Content Understanding converter

##### What's Changed
* [MS] Add OCR layer service for embedded images and PDF scans by @lesyk in https://github.com/microsoft/markitdown/pull/1541
* Fix O(n) memory growth in PDF conversion by calling page.close() afte… by @lesyk in https://github.com/microsoft/markitdown/pull/1612
* Updated warning about binding to non-local interfaces. by @afourney in https://github.com/microsoft/markitdown/pull/1653
* fix: handle deeply nested HTML that triggers RecursionError by @jigangz in https://github.com/microsoft/markitdown/pull/1644
* Clarify security posture in READMEs by @afourney in https://github.com/microsoft/markitdown/pull/1807
* feat: Add Azure Content Understanding converter by @chienyuanchang in https://github.com/microsoft/markitdown/pull/1865
* Bump version to 0.1.6 by @afourney in https://github.com/microsoft/markitdown/pull/1914

##### New Contributors
* @jigangz made their first contribution in https://github.com/microsoft/markitdown/pull/1644
* @chienyuanchang made their first contribution in https://github.com/microsoft/markitdown/pull/1865

**Full Changelog**: https://github.com/microsoft/markitdown/compare/v0.1.5...v0.1.6

### v0.1.5

- Date: 2026-02-20
- Version: v0.1.5
- Original notes: https://github.com/microsoft/markitdown/releases/tag/v0.1.5
- Permalink: https://whatsnew.fyi/product/markitdown/releases/v0.1.5

- **changed** — Update PDF table extraction to support aligned Markdown
- **fixed** — PDF parsing does not support partially numbered lists
- **changed** — Extend table support for wide tables
- **added** — Add text/markdown to Accept header
- **removed** — Remove onnxruntime<=1.20.1 Windows pin

##### What's Changed
* Update PDF table extraction to support aligned Markdown by @lesyk in https://github.com/microsoft/markitdown/pull/1499
* Fix: PDF parsing doesn't support partially numbered lists by @lesyk in https://github.com/microsoft/markitdown/pull/1525
* Extend table support for wide tables by @lesyk in https://github.com/microsoft/markitdown/pull/1552
* Add text/markdown to Accept header by @afourney in https://github.com/microsoft/markitdown/pull/1554
* Remove onnxruntime<=1.20.1 Windows pin by @basnijholt in https://github.com/microsoft/markitdown/pull/1551
* Bump version for release. by @afourney in https://github.com/microsoft/markitdown/pull/1564

##### New Contributors
* @lesyk made their first contribution in https://github.com/microsoft/markitdown/pull/1499
* @basnijholt made their first contribution in https://github.com/microsoft/markitdown/pull/1551

**Full Changelog**: https://github.com/microsoft/markitdown/compare/v0.1.4...v0.1.5

### v0.1.5b1 — Version 0.1.5b1

- Date: 2026-01-08
- Version: v0.1.5b1
- Original notes: https://github.com/microsoft/markitdown/releases/tag/v0.1.5b1
- Permalink: https://whatsnew.fyi/product/markitdown/releases/v0.1.5b1
- Labels: Pre-release

- **changed** — Update PDF table extraction to support aligned Markdown
- **fixed** — PDF parsing does not support partially numbered lists

##### What's Changed
* Update PDF table extraction to support aligned Markdown by @lesyk in https://github.com/microsoft/markitdown/pull/1499
* Fix: PDF parsing doesn't support partially numbered lists by @lesyk in https://github.com/microsoft/markitdown/pull/1525

##### New Contributors
* @lesyk made their first contribution in https://github.com/microsoft/markitdown/pull/1499

**Full Changelog**: https://github.com/microsoft/markitdown/compare/v0.1.4...v0.1.5b1

### v0.1.4 — Version 0.1.4

- Date: 2025-12-01
- Version: v0.1.4
- Original notes: https://github.com/microsoft/markitdown/releases/tag/v0.1.4
- Permalink: https://whatsnew.fyi/product/markitdown/releases/v0.1.4

- **security** — Bumped mammoth to 1.11.0 to address CVE-2025-11849
- **security** — Bumped pdfminer.six to 20251107 to address GHSA-wf5f-4jwr-ppcp

Maintenance release:

Bumps mammoth to 1.11.0 to address [cve-2025-11849](https://avd.aquasec.com/nvd/2025/cve-2025-11849/)
And pdfminer.six to 20251107 to address [GHSA-wf5f-4jwr-ppcp](https://github.com/pdfminer/pdfminer.six/security/advisories/GHSA-wf5f-4jwr-ppcp)

### v0.1.3

- Date: 2025-08-26
- Version: v0.1.3
- Original notes: https://github.com/microsoft/markitdown/releases/tag/v0.1.3
- Permalink: https://whatsnew.fyi/product/markitdown/releases/v0.1.3

- **changed** — Pin onnxruntime on Windows
- **changed** — Have the MarkItDown MCP server read MARKITDOWN_ENABLE_PLUGINS from environment variable
- **fixed** — Resolved an issue with linked images in docx
- **security** — Ensure safe ExifTool usage by requiring version 12.24 or greater
- **changed** — Update document intelligence file type handling for HTML
- **fixed** — Correctly pass custom llm prompt parameter
- **added** — Add support for data-src attribute
- **fixed** — Fix docx parse error with newlines in alt text
- **fixed** — Handle PPTX shapes where position is None
- **added** — Add checkbox support to CustomMarkdownify

##### What's Changed
* Pin `onnxruntime` on Windows by @t-kalinowski in https://github.com/microsoft/markitdown/pull/1274
* Have the MarkItDown MCP server read MARKITDOWN_ENABLE_PLUGINS from ENV by @afourney in https://github.com/microsoft/markitdown/pull/1273
* Resolved an issue with linked images in docx [mammoth] by @afourney in https://github.com/microsoft/markitdown/pull/1405
* Ensure safe ExifTool usage: require >= 12.24 by @t3tra-dev in https://github.com/microsoft/markitdown/pull/1399
* Bump actions/checkout from 4 to 5 by @dependabot[bot] in https://github.com/microsoft/markitdown/pull/1394
* HTML| Update document intelligence file type handling by @safen0s in https://github.com/microsoft/markitdown/pull/1352
* fix: correctly pass custom llm prompt parameter by @stefan-rink in https://github.com/microsoft/markitdown/pull/1319
* Adding support for data-src Attribute by @Noah-Zhuhaotian in https://github.com/microsoft/markitdown/pull/1226
* fix docx parse error (docx testcase: \n in alt) by @BetterAndBetterII in https://github.com/microsoft/markitdown/pull/1163
* Handle PPTX shapes where position is None by @richardye101 in https://github.com/microsoft/markitdown/pull/1161
* Feat: Add checkbox support to _CustomMarkdownify by @Meirna-kamal in https://github.com/microsoft/markitdown/pull/1208

##### New Contributors
* @onefloid made their first contribution in https://github.com/microsoft/markitdown/pull/1278
* @JonahDelman made their first contribution in https://github.com/microsoft/markitdown/pull/1393
* @safen0s made their first contribution in https://github.com/microsoft/markitdown/pull/1352
* @stefan-rink made their first contribution in https://github.com/microsoft/markitdown/pull/1319
* @W-DOS0 made their first contribution in https://github.com/microsoft/markitdown/pull/1335
* @UK0070 made their first contribution in https://github.com/microsoft/markitdown/pull/1350
* @ebrahimHakimuddin made their first contribution in https://github.com/microsoft/markitdown/pull/1191
* @Noah-Zhuhaotian made their first contribution in https://github.com/microsoft/markitdown/pull/1226
* @mdqst made their first contribution in https://github.com/microsoft/markitdown/pull/1173
* @Meirna-kamal made their first contribution in https://github.com/microsoft/markitdown/pull/1208

**Full Changelog**: https://github.com/microsoft/markitdown/compare/v0.1.2...v0.1.3

### v0.1.2

- Date: 2025-05-28
- Version: v0.1.2
- Original notes: https://github.com/microsoft/markitdown/releases/tag/v0.1.2
- Permalink: https://whatsnew.fyi/product/markitdown/releases/v0.1.2

- **added** — Render math equations in .docx documents
- **changed** — Make it easier to use AzureKeyCredentials with Azure Doc Intelligence
- **added** — Add CSV to Markdown table conversion
- **changed** — Switch from the stdlib minidom parser to defusedxml
- **changed** — Update omml.py to use defusedxml
- **fixed** — Fix YouTube transcript errors
- **added** — Support API version selection for Document Intelligence
- **changed** — Support streamable http mcp

##### What's Changed
- feat: render math equations in .docx documents by @sathinduga in https://github.com/microsoft/markitdown/pull/1160
- Make it easier to use AzureKeyCredentials with Azure Doc Intelligence by @afourney in https://github.com/microsoft/markitdown/pull/1151
- Add CSV to Markdown table conversion - fixes https://github.com/microsoft/markitdown/issues/1144 by @erinshek in https://github.com/microsoft/markitdown/pull/1176
- Fix typo in README.md by @lentil32 in https://github.com/microsoft/markitdown/pull/1175
- Update README.md by @createcentury in https://github.com/microsoft/markitdown/pull/1187
- Switched from the stdlib minidom parser to defusedxml. by @afourney in https://github.com/microsoft/markitdown/pull/1259
- Updated omml.py to use defusedxml [python.lang.security.use-defused-xml-parse.use-defused-xml-parse] by @kira-offgrid in https://github.com/microsoft/markitdown/pull/1251
- Chore: Make linter happy by @t3tra-dev in https://github.com/microsoft/markitdown/pull/1256
- FIX YouTube transcript errors by @JoshClark-git in https://github.com/microsoft/markitdown/pull/1241
- feat: support API version selection for Document Intelligence by @kirisame-wang in https://github.com/microsoft/markitdown/pull/1253
- Update Python version requirement and add .cursorrules to .gitignore by @Wuhall in https://github.com/microsoft/markitdown/pull/1249
- support streamable http mcp by @Betula-L in https://github.com/microsoft/markitdown/pull/1245
- docs: fix typos by @rtpacks in https://github.com/microsoft/markitdown/pull/1201itdown/pull/1260

##### New Contributors
@sathinduga made their first contribution in https://github.com/microsoft/markitdown/pull/1160
@erinshek made their first contribution in https://github.com/microsoft/markitdown/pull/1176
@lentil32 made their first contribution in https://github.com/microsoft/markitdown/pull/1175
@createcentury made their first contribution in https://github.com/microsoft/markitdown/pull/1187
@kira-offgrid made their first contribution in https://github.com/microsoft/markitdown/pull/1251
@t3tra-dev made their first contribution in https://github.com/microsoft/markitdown/pull/1256
@JoshClark-git made their first contribution in https://github.com/microsoft/markitdown/pull/1241
@kirisame-wang made their first contribution in https://github.com/microsoft/markitdown/pull/1253
@Wuhall made their first contribution in https://github.com/microsoft/markitdown/pull/1249
@Betula-L made their first contribution in https://github.com/microsoft/markitdown/pull/1245
@rtpacks made their first contribution in https://github.com/microsoft/markitdown/pull/1201

**Full Changelog**: https://github.com/microsoft/markitdown/compare/v0.1.1...v0.1.2

### v0.1.2a1

- Date: 2025-05-21
- Version: v0.1.2a1
- Original notes: https://github.com/microsoft/markitdown/releases/tag/v0.1.2a1
- Permalink: https://whatsnew.fyi/product/markitdown/releases/v0.1.2a1
- Labels: Pre-release

- **added** — Render math equations in .docx documents
- **changed** — Make it easier to use AzureKeyCredentials with Azure Doc Intelligence
- **added** — Add CSV to Markdown table conversion
- **changed** — Switch from the stdlib minidom parser to defusedxml
- **security** — Fix security vulnerability in XML parsing by using defusedxml instead of minidom
- **fixed** — Fix YouTube transcript errors
- **added** — Support API version selection for Document Intelligence
- **added** — Support streamable http mcp

##### What's Changed
* feat: render math equations in .docx documents by @sathinduga in https://github.com/microsoft/markitdown/pull/1160
* Make it easier to use AzureKeyCredentials with Azure Doc Intelligence by @afourney in https://github.com/microsoft/markitdown/pull/1151
* Add CSV to Markdown table conversion - fixes #1144 by @erinshek in https://github.com/microsoft/markitdown/pull/1176
* chore: fix typo in README.md by @lentil32 in https://github.com/microsoft/markitdown/pull/1175
* Update README.md by @createcentury in https://github.com/microsoft/markitdown/pull/1187
* Switched from the stdlib minidom parser to defusedxml. by @afourney in https://github.com/microsoft/markitdown/pull/1259
* Updated packages/markitdown/src/markitdown/converter_utils/docx/math/omml.py to fix security vulnerability [python.lang.security.use-defused-xml-parse.use-defused-xml-parse] by @kira-offgrid in https://github.com/microsoft/markitdown/pull/1251
* Chore: Make linter happy by @t3tra-dev in https://github.com/microsoft/markitdown/pull/1256
* FIX YouTube transcript errors by @JoshClark-git in https://github.com/microsoft/markitdown/pull/1241
* feat: support API version selection for Document Intelligence by @kirisame-wang in https://github.com/microsoft/markitdown/pull/1253
* Update Python version requirement and add .cursorrules to .gitignore by @Wuhall in https://github.com/microsoft/markitdown/pull/1249
* support streamable http mcp by @Betula-L in https://github.com/microsoft/markitdown/pull/1245
* docs: fix typos by @rtpacks in https://github.com/microsoft/markitdown/pull/1201
* Preparing a pre-release of 0.1.2 by @afourney in https://github.com/microsoft/markitdown/pull/1260

##### New Contributors
* @sathinduga made their first contribution in https://github.com/microsoft/markitdown/pull/1160
* @erinshek made their first contribution in https://github.com/microsoft/markitdown/pull/1176
* @lentil32 made their first contribution in https://github.com/microsoft/markitdown/pull/1175
* @createcentury made their first contribution in https://github.com/microsoft/markitdown/pull/1187
* @kira-offgrid made their first contribution in https://github.com/microsoft/markitdown/pull/1251
* @t3tra-dev made their first contribution in https://github.com/microsoft/markitdown/pull/1256
* @JoshClark-git made their first contribution in https://github.com/microsoft/markitdown/pull/1241
* @kirisame-wang made their first contribution in https://github.com/microsoft/markitdown/pull/1253
* @Wuhall made their first contribution in https://github.com/microsoft/markitdown/pull/1249
* @Betula-L made their first contribution in https://github.com/microsoft/markitdown/pull/1245
* @rtpacks made their first contribution in https://github.com/microsoft/markitdown/pull/1201

**Full Changelog**: https://github.com/microsoft/markitdown/compare/v0.1.1...v0.1.2a1

### v0.1.1

- Date: 2025-03-25
- Version: v0.1.1
- Original notes: https://github.com/microsoft/markitdown/releases/tag/v0.1.1
- Permalink: https://whatsnew.fyi/product/markitdown/releases/v0.1.1

- **added** — convert_uri function now handles data and file URIs
- **changed** — convert_url renamed to convert_uri
- **deprecated** — convert_url remains as an alias to convert_uri for backward compatibility

##### What's Changed

`convert_url` renamed to `convert_uri`, and now handles data and file URIs by @afourney in https://github.com/microsoft/markitdown/pull/1153

**NOTE**: `convert_url` remains an alias to `convert_uri`, for backward compatibility.

Both now accept file URIs and data URIs:

e.g., 
```python
markitdown = MarkItDown()
result = markitdown.convert_uri("file:///path/to/file.txt")
print(result.markdown)
```

And, 

```python
markitdown = MarkItDown()
result = markitdown.convert_uri("data:text/plain;base64,SGVsbG8sIFdvcmxkIQ==")
print(result.markdown)
```

**Full Changelog**: https://github.com/microsoft/markitdown/compare/v0.1.0...v0.1.1

### v0.1.0

- Date: 2025-03-22
- Version: v0.1.0
- Original notes: https://github.com/microsoft/markitdown/releases/tag/v0.1.0
- Permalink: https://whatsnew.fyi/product/markitdown/releases/v0.1.0

- **added** — Organized dependencies into optional feature groups installable with pip install markitdown[all]
- **added** — Plugin-based architecture allowing 3rd-party developers to add functionality
- **added** — Support for EPUB format
- **added** — Option to keep data URIs in converted Markdown
- **added** — CLI options to override MIME type, extension, and charset
- **changed** — All conversions are now performed in-memory without temporary files
- **changed** — convert_stream() now requires a binary file-like object instead of text file-like objects
- **changed** — DocumentConverter class interface changed to read from file-like streams rather than file paths
- **fixed** — Skip generating markdown links in pre blocks
- **fixed** — Fix UnboundLocalError in MarkItDown._convert
- **fixed** — Implement retry logic for YouTube transcript fetching and fix URL decoding issue
- **fixed** — Add support for PPTX shape groups to not miss slide content
- **fixed** — Make extensions unique in MarkItDown's convert methods
- **fixed** — Print and log better exceptions when file conversions fail
- **fixed** — Fixed deepcopy failure when passing llm_client
- **fixed** — Sort PPTX shapes to be parsed in top-to-bottom, left-to-right order
- **fixed** — Fix exiftool in well-known paths
- **fixed** — Switch from puremagic to magika for file type detection
- **fixed** — Minimize guesses when guesses are compatible
- **fixed** — Fix string formatting in FileConversionException error message
- **fixed** — Handle unsupported plot types in PPTX
- **fixed** — Have magika read from the stream

##### Overview
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:

* Organized dependencies into feature groups — install only the converters you need, or get everything with `pip install markitdown[all]`
* A new plugin-based architecture, allowing 3rd-party developers to add functionality to MarkItDown (see the [sample plugin](https://github.com/microsoft/markitdown/tree/main/packages/markitdown-sample-plugin))
* All conversions are performed in-memory — no more temporary files
* Support for new formats including EPUB
* Option to keep data URIs in converted Markdown
* Option to override MIME type, extension, and charset in the command-line interface (useful when reading input from a pipe or stdin)

##### Breaking changes
* As noted above, dependencies are now organized into optional feature groups. `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.
* The `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.
 
##### Detailed list of contributions
* Cleanup and refactor, in preparation for plugin support. by @afourney in https://github.com/microsoft/markitdown/pull/318
* Skip generating md links in 'pre' blocks by @t-kalinowski in https://github.com/microsoft/markitdown/pull/322
* Fix a typo in sample RTF plugin by @rickygao in https://github.com/microsoft/markitdown/pull/320
* Added priority argument to all converter constructors. by @afourney in https://github.com/microsoft/markitdown/pull/324
* Doc Intelligence fixes for refactored code by @KennyZhang1 in https://github.com/microsoft/markitdown/pull/325
* Added CLI tests. by @afourney in https://github.com/microsoft/markitdown/pull/327
* Fix UnboundLocalError in MarkItDown._convert by @menezesandre in https://github.com/microsoft/markitdown/pull/1038
* add necessary imports by @tanreinama in https://github.com/microsoft/markitdown/pull/861
* fix: Implement retry logic for YouTube transcript fetching and fix URL decoding issue by @iw4p in https://github.com/microsoft/markitdown/pull/1035
* Add Support For PPTX Shape Groups (Fix in code design to not miss out on slide content) by @C0dingMast3r in https://github.com/microsoft/markitdown/pull/331
* Make sure extensions are unique in MarkItDown's convert methods. by @afourney in https://github.com/microsoft/markitdown/pull/1076
* Don't have ZipConverter accept OOXML files. by @afourney in https://github.com/microsoft/markitdown/pull/1078
* Print and log better exceptions when file conversions fail. by @afourney in https://github.com/microsoft/markitdown/pull/1080
* Exceptions should subclass Exception not BaseException. by @afourney in https://github.com/microsoft/markitdown/pull/1082
* [Draft] Exploring ways to allow Optional dependencies by @afourney in https://github.com/microsoft/markitdown/pull/1079
* Fixed property name by @afourney in https://github.com/microsoft/markitdown/pull/1085
* Update converter API, user streams rather than filepaths by @afourney in https://github.com/microsoft/markitdown/pull/1088
* Bump version. by @afourney in https://github.com/microsoft/markitdown/pull/1094
* Fixed loading of plugins. by @afourney in https://github.com/microsoft/markitdown/pull/1096
* Fixed version. by @afourney in https://github.com/microsoft/markitdown/pull/1097
* fix(README): correct pip install command formatting by @Piero24 in https

_[Truncated at 4000 characters — full notes: https://github.com/microsoft/markitdown/releases/tag/v0.1.0]_

### v0.1.0a6

- Date: 2025-03-21
- Version: v0.1.0a6
- Original notes: https://github.com/microsoft/markitdown/releases/tag/v0.1.0a6
- Permalink: https://whatsnew.fyi/product/markitdown/releases/v0.1.0a6
- Labels: Pre-release

- **added** — Support for preserving base64 encoded images
- **fixed** — Resolve a console encoding error

##### What's Changed
* Add support for preserving base64 encoded images by @BetterAndBetterII in https://github.com/microsoft/markitdown/pull/1140
* Bump version and resolve a console encoding error. by @afourney in https://github.com/microsoft/markitdown/pull/1149

##### New Contributors
* @BetterAndBetterII made their first contribution in https://github.com/microsoft/markitdown/pull/1140

**Full Changelog**: https://github.com/microsoft/markitdown/compare/v0.1.0a5...v0.1.0a6