how-to-guide

How to Create a Custom Plugin for MarkItDown: A Complete Developer Guide

April 11, 2026 microsoft/markitdown ↗

To create a custom plugin for MarkItDown, you define a Python package with a markitdown.plugin entry-point, implement the register_converters() function and __plugin_interface_version__ constant, subclass DocumentConverter to handle your specific file format, and install the package into your environment.

The microsoft/markitdown repository uses a Python entry-point based architecture that allows third-party developers to extend its file conversion capabilities without modifying core source code. When you instantiate MarkItDown with enable_plugins=True, the library

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 →