name: markitdown-skill description: OpenClaw agent skill for converting documents to Markdown. Documentation and utilities for Microsoft's MarkItDown library. Supports PDF, Word, PowerPoint, Excel, images (OCR), audio (transcription), HTML, YouTube. metadata: openclaw: emoji: "📄" homepage: https://github.com/karmanverma/markitdown-skill requires: bins: ["python3", "pip", "markitdown"] install: - id: "markitdown" kind: "pip" package: "markitdown[all]" bins: ["markitdown"] label: "Install MarkItDown CLI (pip)"

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

# Convert file to markdown
markitdown document.pdf -o output.md

# Convert URL
markitdown https://example.com/docs -o docs.md

Supported Formats

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

# Using included script
python ~/.openclaw/skills/markitdown/scripts/batch_convert.py docs/*.pdf -o markdown/ -v

# Or shell loop
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

# Ubuntu/Debian
sudo apt-get install tesseract-ocr

# macOS
brew install tesseract
7w4.net小葱技能站，你的AI助手技能库。

What This Skill Provides

See Also

• USAGE-GUIDE.md - Detailed examples
• reference.md - Full API reference
• Microsoft MarkItDown - Upstream library

这个 Skill 质量中等偏上，文档清晰易懂，安装使用说明详细，但内容主要是对外部工具的使用说明文档，缺少原创性的增值功能。如果你需要将 PDF、Word 等文档转换为 Markdown，它能提供良好的操作指引，不过核心转换能力取决于微软的 markitdown 库本身。文档配套完善，但实际工具功能较为基础。