how-to-guide

How to Override MarkItDown's Converter Priority for Custom Converters

April 11, 2026 microsoft/markitdown ↗

Register your custom DocumentConverter using MarkItDown.register_converter() with an explicit priority value—lower numbers run first, with built-ins starting at 0.0 and 10.0.

The microsoft/markitdown library determines which converter handles a file by maintaining an ordered list of registrations. Each registration pairs a DocumentConverter instance with a numeric priority value. To override MarkItDown's converter priority for custom converters, you specify a priority value when registering your class, ensuring it runs before or after the built-in

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 →