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

> Understand MarkItDown's converter priority system. Learn how lower numbers mean higher precedence for document conversion ordering, with defaults for specific and generic converters.

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

---

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