К основному содержанию
скилл CX Codex

markitdown-skill — скилл для Claude Code: что делает и как установить

Скилл markitdown-skill для Claude Code переводит документы и веб-страницы в Markdown через CLI markitdown. Выполняет OCR изображений, транскрибирует аудио и пакетно обрабатывает папки.

Apache-2.0 ★ 108 обновлён 2026-11-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add cjh-solver/MathModeling-Skills-Arsenal --skill markitdown-skill -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/markitdown-skill/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/markitdown-skill/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
markitdown julianobarbosa Скилл-инструкция по Microsoft MarkItDown: превращает PDF, Word, Excel, картинки и ссылки в Markdown, готовый для контекста LLM. CX Codex +1 1 700установок markdown-converter steipete Скилл markdown-converter переводит офисные документы, таблицы, PDF, разметку и медиафайлы в чистый Markdown прямо через uvx без ручной настройки парсеров. CX Codex +1 346установок anymd SylphxAI MCP-сервер anymd преобразует PDF, офисные документы, веб-страницы и медиафайлы в Markdown прямо на машине. Пригодится агентам для чтения контекста без внешних облачных API. CX Codex +1 ★ 1 074звёзд репо docling.rs docling-project MCP-сервер docling.rs превращает PDF, Office, HTML и сканы в Markdown с сохранением структуры — заголовки, таблицы и OCR для агентов. CX Codex +1 ★ 144звёзд репо mcp BiGapi-2026 MCP-сервер mcp преобразует результаты работы агента в готовые файлы: сшивает и чистит PDF, распознаёт текст через OCR, конвертирует форматы Office и подписывает документы. CX Codex +1 damnpdfs Sourav Bera Подключает 71 инструмент для обработки PDF, офисных документов и картинок через вкладку DamnPDFs в браузере. CX Codex ★ 1 596звёзд репо

Из того же набора10

Весь набор →
tech-route-maker Правило tech-route-maker для Claude Code помогает создавать редактируемые диаграммы исследовательских и инженерных маршрутов по источникам. Оно включается при запросах на схемы методов, дорожные карты и рабочие процессы. CX Codex +1 ★ 108звёзд репо code_repair Промпт code_repair для Claude Code исправляет проблемы из технических и визуальных отчётов. Он сохраняет текущий подход к построению графиков и зависимости. GP ChatGPT ★ 108звёзд репо visual_quality_check Промпт visual_quality_check для Claude Code сверяет сгенерированный график с требованиями задачи, выбранным шаблоном и отчётом. Фиксирует только дефекты с самого изображения или из отчётов. GP ChatGPT ★ 108звёзд репо template_adaptation Промпт template_adaptation для Claude Code переносит реальные данные в выбранный шаблон. Он сохраняет исходное оформление и структуру там, где это возможно. GP ChatGPT ★ 108звёзд репо bzd-review-paper Скилл bzd-review-paper для Claude Code оценивает статью по математическому моделированию и проверяет её соответствие условиям конкурса. Для разбора нужны полный текст задачи и статья команды. CX Codex +1 ★ 108звёзд репо tikz-scientific-figures Скилл tikz-scientific-figures для Claude Code рисует рисунки для статьи или отчёта на TikZ и PGFPlots и отдаёт SVG с PNG. Один рисунок — один standalone-файл .tex, и он остаётся редактируемым. CX Codex +1 ★ 108звёзд репо modelviz-skill Скилл modelviz-skill для Claude Code строит научные графики по таблицам и запросу на естественном языке. Он выбирает шаблон, подгоняет его под данные и проверяет результат. CX Codex +1 ★ 108звёзд репо tech-route-maker Скилл tech-route-maker для Claude Code строит редактируемые схемы технических маршрутов и исследовательских пайплайнов по исходным материалам. Включается по запросу диаграммы или команде $tech-route-maker. CX Codex +1 ★ 108звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой