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.

What's Changed

• Pin GitHub Actions to full-length commit SHAs by Dan Fiedler (@danfiedler-msft) in #2316
• Mitigate UnicodeDecodeError due to wrong ASCII charset guess for long files by Fabio Catalano (@fcatalan92) in #2360
• fix: support extended content-disposition filenames by Rāna(Bass Ver.) (@cat0825) in #2045
• fix: fall back to plain text when RSS item content triggers RecursionError by Jeremy Schoemaker (@shoemoney) in #2333
• fix(cli): allow Content Understanding conversion from stdin by Tyyyy (@uczltw6) in #2318
• fix: correct \underleftarrow macro and map math italic h in equation conversion by Guillermo Dols (@gdols) in #2293
• feat(cli): support MARKITDOWN_CU_ENDPOINT / MARKITDOWN_DOCINTEL_ENDPOINT by Sinan Olsson-Pasic (@seenws) in #2358
• fix(csv): strip the UTF-8 BOM and skip blank rows before building the table by Ruiming Zhao (@uuzzrm) in #2303
• Preserve strikethrough from <strike> and CSS line-through by Gyanu Mayank (@gyanu2507) in #2342
• Fix percent-encoded Windows drive paths in file URIs by Zhewen Tan (@tandede) in #2315
• fix: escape pipes and newlines in CSV values by Asjad Abbas (@asjad3) in #2266
• fix(epub): safely extract metadata text without crashing on None nodeValue or nested elements by Henry Su (@hsusul) in #2247
• fix: handle math run with no text child in OMML->LaTeX conversion by S1MS4 in #2189
• fix: IpynbConverter.accepts() catches UnicodeDecodeError on non-decodable content (fixes #1894) by hanhan761 in #1929
• fix(docx): ignore malformed styles missing type by S M (@gingerninja85) in #2190
• Preserve percent-encoded octets in href paths by Sonai Biswas (@Sonai124) in #2173
• fix: remove extra closing brace from caron and ring-above accent templates by Andrew Avery (@AndrewAvery7) in #2279
• fix: preserve strikethrough semantics for <strike>, line-through CSS, and w:dstrike by MOHAMMED WASIM KHAN (@wasim-builds) in #2356
• fix: buffer CLI stdin before format detection on Windows by Mo Hui (@mohui666) in #2351
• fix(rss): preserve Atom XHTML content by will wang (@weivwang) in #2297
• fix: initialize md_text in _parse_rss_type to prevent UnboundLocalError by Sai Medavarapu (@smedavarapu1) in #2164
• fix: ZipConverter renders '(unknown)' instead of literal 'None' when stream has no source info by JSap0914 in #2134
• fix: truncate uppercase data image URIs by Lucas Ma (@pony-maggie) in #2122
• fix(doc-intel): default api_version to None in DocumentIntelligenceConverter by Nefelibata (@MeiSiristhebest) in #2267
• fix(outlook): read .msg string properties saved in the non-Unicode format by Guillermo Dols (@gdols) in #2295
• fix: handle URI schemes case-insensitively by Lucas Ma (@pony-maggie) in #2121
• fix: normalize data URI parameter case by Lucas Ma (@pony-maggie) in #2120
• fix(xlsx): tolerate legacy showZeroes sheet views by Yufeng He (@he-yufeng) in #2064
• docs: use canonical markdown result property by Sheroy Cooper (@CooperSheroy) in #2259
• fix(youtube): handle missing title metadata without raising AssertionError by Henry Su (@hsusul) in #2238
• Bump actions/checkout from 5.1.0 to 7.0.1 by Dependabot (@dependabot)[bot] in #2320
• Bump actions/setup-python from 5.6.0 to 7.0.0 by Dependabot (@dependabot)[bot] in #2321
• fix(ipynb): preserve leading # in notebook heading titles by Cpthimself (@Alphaxiaoteng) in #2371
• fix(docx): preserve underlined text by Yufeng He (@he-yufeng) in #2017
• fix(pptx): ignore empty llm captions by Lubrsy (@Lubrsy706) in #1886
• fix: PptxConverter tolerates None shape.text and notes text by Alvin Tang (@alvinttang) in #2059
• fix(pptx): prevent crash in PptxConverter when chart title lacks a text frame by aoright (@aoright) in #2194
• fix: catch OSError when exiftool binary is missing (#1960) by 王艺霖 (@doitgo) in #2082
• Fix exiftool JSON decoding to use UTF-8 by Vedant (@Vedant43hh) in #2067
• fix: WikipediaConverter renders hash None heading when page has no title by hanhan761 in #1990
• fix: guard against missing oMath element in DOCX math converter (#1979) by hanhan761 in #1995
• fix: handle DOCX files with inconsistent ZIP filename casing (#1812) by liyrds (@lyydsheep) in #2016
• Support short YouTube URLs by Mukunda Rao Katta (@MukundaKatta) in #1882
• fix: suppress pydub RuntimeWarning when ffmpeg is missing (fixes #1685) by hanhan761 in #1985
• chore: remove unused mammoth import from PlainTextConverter (#1951) by hanhan761 in #1953
• fix(rss): treat Atom text content and summary as plain text by Lazizbek Ergashev (@lazerg) in #2374
• fix: ImageConverter gracefully handles LLM API failures (fixes #1942) by hanhan761 in #1948
• fix(docx): handle unknown math functions in OMML converter without crashing by Nefelibata (@MeiSiristhebest) in #2268
• Update README to help scope PRs. by afourney in #2376

New Contributors

• Dan Fiedler (@danfiedler-msft) made their first contribution in #2316
• Fabio Catalano (@fcatalan92) made their first contribution in #2360
• Rāna(Bass Ver.) (@cat0825) made their first contribution in #2045
• Jeremy Schoemaker (@shoemoney) made their first contribution in #2333
• Tyyyy (@uczltw6) made their first contribution in #2318
• Guillermo Dols (@gdols) made their first contribution in #2293
• Sinan Olsson-Pasic (@seenws) made their first contribution in #2358
• Ruiming Zhao (@uuzzrm) made their first contribution in #2303
• Gyanu Mayank (@gyanu2507) made their first contribution in #2342
• Zhewen Tan (@tandede) made their first contribution in #2315
• Asjad Abbas (@asjad3) made their first contribution in #2266
• Henry Su (@hsusul) made their first contribution in #2247
• S1MS4 made their first contribution in #2189
• hanhan761 made their first contribution in #1929
• S M (@gingerninja85) made their first contribution in #2190
• Sonai Biswas (@Sonai124) made their first contribution in #2173
• Andrew Avery (@AndrewAvery7) made their first contribution in #2279
• MOHAMMED WASIM KHAN (@wasim-builds) made their first contribution in #2356
• Mo Hui (@mohui666) made their first contribution in #2351
• will wang (@weivwang) made their first contribution in #2297
• Sai Medavarapu (@smedavarapu1) made their first contribution in #2164
• JSap0914 made their first contribution in #2134
• Lucas Ma (@pony-maggie) made their first contribution in #2122
• Nefelibata (@MeiSiristhebest) made their first contribution in #2267
• Yufeng He (@he-yufeng) made their first contribution in #2064
• Sheroy Cooper (@CooperSheroy) made their first contribution in #2259
• Cpthimself (@Alphaxiaoteng) made their first contribution in #2371
• Lubrsy (@Lubrsy706) made their first contribution in #1886
• Alvin Tang (@alvinttang) made their first contribution in #2059
• aoright (@aoright) made their first contribution in #2194
• 王艺霖 (@doitgo) made their first contribution in #2082
• Vedant (@Vedant43hh) made their first contribution in #2067
• liyrds (@lyydsheep) made their first contribution in #2016
• Mukunda Rao Katta (@MukundaKatta) made their first contribution in #1882
• Lazizbek Ergashev (@lazerg) made their first contribution in #2374

Full Changelog: v0.1.7...v0.1.8a1

What's Changed

• fix: avoid O(n^2) value lookups in PPTX chart conversion by kz-000 in #2227
• Fix invalid LaTeX macros for mu, nu, tau, and down-arrow in equation conversion by KRISHNA (@ksprajapatii) in #2228
• Fix typos and formatting in comments, docstrings, and markdown by Chien Yuan Chang (@chienyuanchang) in #2223
• fix: handle PPTX SVG images without a rasterized fallback by Guoyu Wang (@guoyu-wang) in #2233
• Fix omml template bugs. by afourney in #2257

New Contributors

• kz-000 made their first contribution in #2227
• KRISHNA (@ksprajapatii) made their first contribution in #2228
• Guoyu Wang (@guoyu-wang) made their first contribution in #2233

Full Changelog: v0.1.6...v0.1.7

What's Changed

• [MS] Add OCR layer service for embedded images and PDF scans by lesyk in #1541
• Fix O(n) memory growth in PDF conversion by calling page.close() afte… by lesyk in #1612
• Updated warning about binding to non-local interfaces. by afourney in #1653
• fix: handle deeply nested HTML that triggers RecursionError by Jigang (Harry) Zhou (@jigangz) in #1644
• Clarify security posture in READMEs by afourney in #1807
• feat: Add Azure Content Understanding converter by Chien Yuan Chang (@chienyuanchang) in #1865
• Bump version to 0.1.6 by afourney in #1914

New Contributors

• Jigang (Harry) Zhou (@jigangz) made their first contribution in #1644
• Chien Yuan Chang (@chienyuanchang) made their first contribution in #1865

Full Changelog: v0.1.5...v0.1.6

What's Changed

• Update PDF table extraction to support aligned Markdown by lesyk in #1499
• Fix: PDF parsing doesn't support partially numbered lists by lesyk in #1525
• Extend table support for wide tables by lesyk in #1552
• Add text/markdown to Accept header by afourney in #1554
• Remove onnxruntime<=1.20.1 Windows pin by Bas Nijholt (@basnijholt) in #1551
• Bump version for release. by afourney in #1564

New Contributors

• lesyk made their first contribution in #1499
• Bas Nijholt (@basnijholt) made their first contribution in #1551

Full Changelog: v0.1.4...v0.1.5

What's Changed

• Update PDF table extraction to support aligned Markdown by lesyk in #1499
• Fix: PDF parsing doesn't support partially numbered lists by lesyk in #1525

New Contributors

• lesyk made their first contribution in #1499

Full Changelog: v0.1.4...v0.1.5b1

Maintenance release:

Bumps mammoth to 1.11.0 to address cve-2025-11849
And pdfminer.six to 20251107 to address GHSA-wf5f-4jwr-ppcp

What's Changed

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

New Contributors

• Florian Scherzberg (@onefloid) made their first contribution in #1278
• JonahDelman made their first contribution in #1393
• safen0s (@safen0s) made their first contribution in #1352
• Stefan Rink (@stefan-rink) made their first contribution in #1319
• [W]DOS_ (@W-DOS0) made their first contribution in #1335
• Utkarsh kumar (@UK0070) made their first contribution in #1350
• Ebrahim Tayabali (@ebrahimHakimuddin) made their first contribution in #1191
• Noah Zhu (@Noah-Zhuhaotian) made their first contribution in #1226
• Dmitry (@mdqst) made their first contribution in #1173
• Meirna (@Meirna-kamal) made their first contribution in #1208

Full Changelog: v0.1.2...v0.1.3

What's Changed

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

New Contributors

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

What's Changed

• feat: render math equations in .docx documents by Sathindu (@sathinduga) in #1160
• Make it easier to use AzureKeyCredentials with Azure Doc Intelligence by afourney in #1151
• Add CSV to Markdown table conversion - fixes #1144 by Turdıbek (@erinshek) in #1176
• chore: fix typo in README.md by lentil32 (@lentil32) in #1175
• Update README.md by wip (@createcentury) in #1187
• Switched from the stdlib minidom parser to defusedxml. by afourney in #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 #1251
• Chore: Make linter happy by t3tra (@t3tra-dev) in #1256
• FIX YouTube transcript errors by JoshClark-git in #1241
• feat: support API version selection for Document Intelligence by Yi-Cheng Wang (@kirisame-wang) in #1253
• Update Python version requirement and add .cursorrules to .gitignore by 一I (@Wuhall) in #1249
• support streamable http mcp by Betula-L in #1245
• docs: fix typos by rtpacks (@rtpacks) in #1201
• Preparing a pre-release of 0.1.2 by afourney in #1260

New Contributors

• 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.2a1

What's Changed

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