Extending Without Changing This Repo

Extend MarkItDown without changing the core repository by publishing your own 3rd-party conversion plugin.

MarkItDown supports 3rd-party plugins, so support for a new format can be published and installed independently of this repository:

markitdown --list-plugins
markitdown --use-plugins path-to-file.pdf

See packages/markitdown-sample-plugin to get started, and tag your repository #markitdown-plugin so that others can find it.

See also Plugins for how end users list and enable plugins.

What to Contribute

What's in scope and out of scope for MarkItDown contributions, including converter fidelity, plugins, and excluded application types.

Running Tests & Checks

How to run MarkItDown's test suite and pre-commit checks locally, with hatch, or inside a Devcontainer.