git:20260508.3a56241 to git:20260509.51ee7e5

1 added, 1 removed. Audit A to A.

---

name: markdown-converter

- description: "Markitdown conversion to Markdown: PDF, Office, HTML, CSV/JSON/XML, images OCR/EXIF, audio transcript, ZIP, YouTube, EPUB."

+ description: "Markitdown to Markdown: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube."

---

# Markdown Converter

Convert files to Markdown using `uvx markitdown` — no installation required.

## Basic Usage

```bash

# Convert to stdout

uvx markitdown input.pdf

# Save to file

uvx markitdown input.pdf -o output.md

uvx markitdown input.docx > output.md

# From stdin

cat input.pdf | uvx markitdown

```

## Supported Formats

- **Documents**: PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls)

- **Web/Data**: HTML, CSV, JSON, XML

- **Media**: Images (EXIF + OCR), Audio (EXIF + transcription)

- **Other**: ZIP (iterates contents), YouTube URLs, EPub

## Options

```bash

-o OUTPUT # Output file

-x EXTENSION # Hint file extension (for stdin)

-m MIME_TYPE # Hint MIME type

-c CHARSET # Hint charset (e.g., UTF-8)

-d # Use Azure Document Intelligence

-e ENDPOINT # Document Intelligence endpoint

--use-plugins # Enable 3rd-party plugins

--list-plugins # Show installed plugins

```

## Examples

```bash

# Convert Word document

uvx markitdown report.docx -o report.md

# Convert Excel spreadsheet

uvx markitdown data.xlsx > data.md

# Convert PowerPoint presentation

uvx markitdown slides.pptx -o slides.md

# Convert with file type hint (for stdin)

cat document | uvx markitdown -x .pdf > output.md

# Use Azure Document Intelligence for better PDF extraction

uvx markitdown scan.pdf -d -e "https://your-resource.cognitiveservices.azure.com/"

```

## Notes

- Output preserves document structure: headings, tables, lists, links

- First run caches dependencies; subsequent runs are faster

- For complex PDFs with poor extraction, use `-d` with Azure Document Intelligence