deep-dive

How MarkItDown's Converter Priority System Works: A Deep Dive into Document Conversion Ordering

April 11, 2026 microsoft/markitdown ↗

MarkItDown's converter priority system assigns numeric priority values to document converters where lower numbers indicate higher precedence, with specific file format converters defaulting to 0.0 and generic converters defaulting to 10.0.

The microsoft/markitdown library implements a priority-driven architecture to determine which DocumentConverter handles a given input stream. Understanding how this MarkItDown converter priority mechanism orders competing implementations enables developers to customize conversion pipelines and override built-in behaviors with precision.

Understanding Priority Constants and Defaults

The priority system centers on

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 →