how-to-guide

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

April 11, 2026 microsoft/markitdown ↗

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

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 →