# How to Use MarkItDown with Azure Document Intelligence: A Complete Guide

> Learn how to use MarkItDown with Azure Document Intelligence to convert PDFs images and Office docs to clean Markdown using AI powered layout analysis. Explore our guide.

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

---

**MarkItDown integrates with Azure Document Intelligence through the optional `DocumentIntelligenceConverter` class to convert PDFs, Office documents, and images into clean Markdown using AI-powered layout analysis.**

The `microsoft/markitdown` repository provides a lightweight, extensible document conversion framework. When you need high-accuracy extraction from complex layouts, you can use MarkItDown with Azure Document Intelligence by enabling the optional converter that leverages the Azure AI Document Intelligence SDK.

## Installation and Prerequisites

The Azure Document Intelligence integration ships as an optional dependency to keep the base package lightweight. You