markitdown-skill — скилл для Claude Code: что делает и как установить
Скилл markitdown-skill для Claude Code переводит документы и веб-страницы в Markdown через CLI markitdown. Выполняет OCR изображений, транскрибирует аудио и пакетно обрабатывает папки.
Apache-2.0 ★ 108 обновлён 2026-11-17
npx skills add cjh-solver/MathModeling-Skills-Arsenal --skill markitdown-skill -a claude-codeЧто делает markitdown-skill
Скилл преобразует файлы PDF, Word, PowerPoint, Excel, HTML, видео с YouTube и веб-страницы в разметку Markdown. При обработке сохраняются заголовки, списки, таблицы и метаданные EXIF из фотографий.
В состав скилла входят справочные руководства и утилита scripts/batch_convert.py для пакетной конвертации директорий. Само преобразование выполняет библиотека Microsoft markitdown, вызываемая через терминал или Python API.
Для работы в системе нужны Python 3, pip и установленный пакет pip install 'markitdown[all]'. Для оптического распознавания текста на картинках потребуется системный пакет Tesseract OCR.
Какие задачи решает
- конвертировать таблицы Excel и презентации PowerPoint в Markdown
- извлечь текст со структурой из файлов PDF и Word
- распознать текст на изображениях через OCR с сохранением EXIF
- получить текстовую расшифровку из аудиозаписей или роликов YouTube
- пакетно преобразовать каталог документов скриптом
Примеры запросов агенту
- Сконвертируй document.pdf в Markdown и сохрани в output.md
- Вытяни текст и структуру страницы https://example.com/docs в docs.md
- Запусти пакетную конвертацию файлов из папки docs/ в каталог markdown/
Как установить markitdown-skill
1Через Skills CLI (Vercel)
npx skills add cjh-solver/MathModeling-Skills-Arsenal --skill markitdown-skill -a claude-code2Вручную: положить файлы
~/.claude/skills/markitdown-skill/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/markitdown-skill/
1Через Skills CLI (Vercel)
npx skills add cjh-solver/MathModeling-Skills-Arsenal --skill markitdown-skill -a codex2Вручную: положить файлы
.agents/skills/markitdown-skill/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cjh-solver/MathModeling-Skills-Arsenal --skill markitdown-skill -a cursor2Вручную: положить файлы
.cursor/skills/markitdown-skill/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cjh-solver/MathModeling-Skills-Arsenal skills/05-toolkit/markitdown-skill2Вручную: положить файлы
.github/skills/markitdown-skill/SKILL.md1Через Skills CLI (Vercel)
npx skills add cjh-solver/MathModeling-Skills-Arsenal --skill markitdown-skill -a gemini-cli2Командой платформы
gemini skills install https://github.com/cjh-solver/MathModeling-Skills-Arsenal --path skills/05-toolkit/markitdown-skillВручную: положить файлы
.devin/skills/markitdown-skill/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о markitdown-skill
Как установить markitdown-skill в Claude Code?
Выполните команду npx skills add cjh-solver/MathModeling-Skills-Arsenal --skill markitdown-skill -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/markitdown-skill/SKILL.md.
Что делает markitdown-skill?
Скилл передаёт агенту инструкции и готовый скрипт для преобразования офисных документов, веб-страниц, аудио и графических файлов в Markdown через CLI Microsoft MarkItDown.
Что нужно для работы markitdown-skill?
В окружении должны быть установлены Python 3, pip и библиотека командой pip install 'markitdown[all]'. Для распознавания текста с картинок нужен установленный в ОС Tesseract OCR.
Исходный текст
SKILL.md · Apache-2.0
---
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: "\U0001F4C4"
requires:
bins:
- python3
- pip
- markitdown
install:
- package-manager: pip
command: "pip install 'markitdown[all]'"
display_name: "markitdown-skill"
display_name_en: "markitdown-skill"
visibility: "public"
icon: "https://codebuddy-platform-1258344699.cos.accelerate.myqcloud.com/public/45edac6b-2078-4678-89f3-6f9800cf5e5f/avatar/skill/au_78915a1e-864.png"
---
# MarkItDown Skill
Documentation and utilities for converting documents to Markdown using Microsoft's [MarkItDown](https://github.com/microsoft/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
```bash
# Convert file to markdown
markitdown document.pdf -o output.md
# Convert URL
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:
```bash
pip install 'markitdown[all]'
```
Or install specific formats only:
```bash
pip install 'markitdown[pdf,docx,pptx]'
```
## Common Patterns
### Fetch Documentation
```bash
markitdown https://github.com/user/repo/blob/main/README.md -o readme.md
```
### Convert PDF
```bash
markitdown document.pdf -o document.md
```
### Batch Convert
```bash
# 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
```python
from markitdown import MarkItDown
md = MarkItDown()
result = md.convert("document.pdf")
print(result.text_content)
```
## Troubleshooting
### "markitdown not found"
```bash
pip install 'markitdown[all]'
```
### OCR Not Working
```bash
# Ubuntu/Debian
sudo apt-get install tesseract-ocr
# macOS
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
- [USAGE-GUIDE.md](references/USAGE-GUIDE.md) - Detailed examples
- [reference.md](references/reference.md) - Full API reference
- [Microsoft MarkItDown](https://github.com/microsoft/markitdown) - Upstream library
© cjh-solver · Apache-2.0 · cjh-solver/MathModeling-Skills-Arsenal