migration-guide

MarkItDown Stream-Based Conversion Breaking Changes: The v0.1.0 Migration Guide

April 11, 2026 microsoft/markitdown ↗

MarkItDown 0.1.0 introduced breaking changes by switching from path-based to stream-based document conversion, requiring binary streams (BinaryIO) instead of file paths and rejecting text-only streams.

The Microsoft MarkItDown library underwent a fundamental architectural overhaul in version 0.1.0, migrating from filesystem-centric processing to pure stream-based conversion. This shift eliminated temporary file I/O but forced changes to method signatures, plugin interfaces, and input handling. Understanding these breaking changes is essential for maintaining compatibility when upgrading from pre-0.1.

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:

curl -s "https://instagit.com/install.md"

Add to your MCP client configuration:

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}

Ask your agent:

"Use Instagit MCP to understand how microsoft/markitdown works."

Works with

Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →