| name | markitdown-skill |
| description | Convert documents to Markdown using Microsoft's MarkItDown CLI (`markitdown`). Supports PDF, Word, PowerPoint, Excel, images (OCR), audio (transcription), HTML, YouTube, and URLs. Use when a user wants to convert a file or URL to Markdown, extract text from PDFs/images, transcribe audio/video, or batch-convert documents. |
| description_zh | 文档转 Markdown(PDF/Word/PPT/图片OCR/音频转写/网页) |
| description_en | Convert documents to Markdown (PDF, Word, PPT, images, audio, URLs) |
| version | 1.0.1 |
| homepage | https://github.com/microsoft/markitdown |
| allowed-tools | Read,Write,Bash,Glob |
| metadata | {"clawdbot":{"emoji":"📄","requires":{"bins":["python3","pip","markitdown"]},"install":[{"package-manager":"pip","command":"pip install 'markitdown[all]'"}]}} |
MarkItDown Skill
Documentation and utilities for converting documents to Markdown using Microsoft's MarkItDown library.
Note: This skill provides documentation and a batch script. The actual conversion is done by the markitdown CLI/library installed via pip.
When to Use
Use markitdown for:
- 📄 Fetching documentation (README, API docs)
- 🌐 Converting web pages to markdown
- 📝 Document analysis (PDFs, Word, PowerPoint)
- 🎬 YouTube transcripts
- 🖼️ Image text extraction (OCR)
- 🎤 Audio transcription
Quick Start
markitdown document.pdf -o output.md
markitdown https://example.com/docs -o docs.md
Supported Formats
| Format | Features |
|---|
| PDF | Text extraction, structure |
| Word (.docx) | Headings, lists, tables |
| PowerPoint | Slides, text |
| Excel | Tables, sheets |
| Images | OCR + EXIF metadata |
| Audio | Speech transcription |
| HTML | Structure preservation |
| YouTube | Video transcription |
Installation
The skill requires Microsoft's markitdown CLI:
pip install 'markitdown[all]'
Or install specific formats only:
pip install 'markitdown[pdf,docx,pptx]'
Common Patterns
Fetch Documentation
markitdown https://github.com/user/repo/blob/main/README.md -o readme.md
Convert PDF
markitdown document.pdf -o document.md
Batch Convert
python ~/.openclaw/skills/markitdown/scripts/batch_convert.py docs/*.pdf -o markdown/ -v
for file in docs/*.pdf; do
markitdown "$file" -o "${file%.pdf}.md"
done
Python API
from markitdown import MarkItDown
md = MarkItDown()
result = md.convert("document.pdf")
print(result.text_content)
Troubleshooting
"markitdown not found"
pip install 'markitdown[all]'
OCR Not Working
sudo apt-get install tesseract-ocr
brew install tesseract
What This Skill Provides
| Component | Source |
|---|
markitdown CLI | Microsoft's pip package |
markitdown Python API | Microsoft's pip package |
scripts/batch_convert.py | This skill (utility) |
| Documentation | This skill |
See Also
