| name | markitdown-converter |
| version | 1.0.0 |
| description | Convert files to Markdown using Microsoft's MarkItDown library |
| category | utilities |
| tags | ["file-conversion","markdown","pdf","docx","xlsx","images","audio"] |
| tools | ["Bash","Read","Write"] |
| created_by | skill-creator |
| compliance_status | created-via-research-synthesis |
| research_synthesis | true |
| verified | true |
| source | builtin |
| trust_score | 100 |
| provenance_sha | 16e3fa3301dfb5c6 |
MarkItDown Converter Skill
Convert files (PDF, DOCX, XLSX, PPTX, HTML, CSV, images, audio) to Markdown using Microsoft's MarkItDown library.
Usage
Skill({ skill: 'markitdown-converter' });
Supported File Types
| Format | Extensions |
|---|
| Documents | .pdf, .docx, .pptx, .xlsx |
| Web | .html, .htm |
| Data | .csv, .json, .xml |
| Images | .jpg, .jpeg, .png, .gif, .webp |
| Audio | .mp3, .wav, .m4a |
| Archives | .zip (extracts and converts contents) |
| Video platforms | YouTube URLs |
Installation
pip install 'markitdown[all]'
CLI Wrapper
The CLI wrapper is at .claude/tools/cli/markitdown-convert.py.
Convert a file to stdout
python .claude/tools/cli/markitdown-convert.py /path/to/file.pdf
Convert and save to output file
python .claude/tools/cli/markitdown-convert.py /path/to/file.pdf /path/to/output.md
Convert with explicit extension hint (for streams)
python .claude/tools/cli/markitdown-convert.py /path/to/file --ext .pdf
Exit Codes
| Code | Meaning |
|---|
| 0 | Success — JSON with text_content |
| 1 | Conversion error |
| 2 | File not found |
| 3 | markitdown not installed |
JSON Output Format
{
"success"