# markitdown

> Utility tool for converting various files to Markdown

- **URL**: https://www.freshcrate.ai/projects/markitdown
- **Author**: pypi
- **Category**: Developer Tools
- **Latest version**: `main@2026-05-26` (2026-05-26)
- **License**: Unknown
- **Source**: https://github.com/microsoft/markitdown#readme
- **Homepage**: https://pypi.org/project/markitdown/
- **Language**: Python
- **GitHub**: 113,982 stars, 7,408 forks
- **Registry**: pypi (`markitdown`)
- **Tags**: `pypi`

## Description

# MarkItDown

> [!IMPORTANT]
> MarkItDown is a Python package and command-line utility for converting various files to Markdown (e.g., for indexing, text analysis, etc). 
>
> For more information, and full documentation, see the project [README.md](https://github.com/microsoft/markitdown) on GitHub.

## Installation

From PyPI:

```bash
pip install markitdown[all]
```

From source:

```bash
git clone git@github.com:microsoft/markitdown.git
cd markitdown
pip install -e packages/markitdown[all]
```

## Usage

### Command-Line

```bash
markitdown path-to-file.pdf > document.md
```

### Python API

```python
from markitdown import MarkItDown

md = MarkItDown()
result = md.convert("test.xlsx")
print(result.text_content)
```

### More Information

For more information, and full documentation, see the project [README.md](https://github.com/microsoft/markitdown) on GitHub.

## Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft
trademarks or logos is subject to and must follow
[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
Any use of third-party trademarks or logos are subject to those third-party's policies.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `main@2026-05-26` | 2026-05-26 | High | Latest activity on main branch |
| `0.1.5` | 2026-04-21 | Low | Imported from PyPI (0.1.5) |
| `main@2026-04-20` | 2026-04-20 | High | Latest activity on main branch |
| `main@2026-04-20` | 2026-04-20 | High | Latest activity on main branch |
| `main@2026-04-20` | 2026-04-20 | High | Latest activity on main branch |
| `main@2026-04-20` | 2026-04-20 | Medium | Latest activity on main branch |
| `main@2026-04-20` | 2026-04-20 | Medium | Latest activity on main branch |
| `main@2026-04-20` | 2026-04-20 | Medium | Latest activity on main branch |
| `main@2026-04-20` | 2026-04-20 | Medium | Latest activity on main branch |
| `main@2026-04-20` | 2026-04-20 | Medium | Latest activity on main branch |

## Citation

- HTML: https://www.freshcrate.ai/projects/markitdown
- Markdown: https://www.freshcrate.ai/projects/markitdown.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/markitdown/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._