What to Contribute¶

MarkItDown is a Python utility for converting files to Markdown for use with LLMs and related text analysis pipelines. This repository is intended to provide Python libraries that can be incorporated into other systems — not the end-user applications built on top of them.

In scope¶

Improvements to the fidelity of existing converters (new formats are added sparingly — especially if they incur new dependencies. In most cases, new formats can be better supported via 3rd-party plugins).
Bug fixes, performance improvements, and security fixes
The markitdown command-line interface
The markitdown-mcp package
Tests, documentation, and developer tooling

Out of scope¶

We cannot accept additional applications, services, or servers. This includes:

Web servers, REST or HTTP APIs, and hosted conversion services
Web frontends and browser-based user interfaces
Desktop and mobile applications (PyQt, PySide, Tkinter, Electron, Flutter, and similar)

Projects like these are genuinely useful, and we would rather see them thrive than be turned away. If you are interested in providing a web service, API, or graphical application for MarkItDown, please maintain it as a separate package or project that depends on markitdown from PyPI.