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

> Learn about MarkItDown 0.1.0 breaking changes. Discover how stream-based conversion requires binary streams and no longer accepts text-only streams. Migrate your MarkItDown projects.

- Repository: [Microsoft/markitdown](https://github.com/microsoft/markitdown)
- Tags: migration-guide
- Published: 2026-04-11

---

**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.