Agent Skills › virgo777/buddyme › markitdown-skill

markitdown-skill

GitHub

基于微软MarkItDown库的Agent技能，支持将PDF、Word、PPT、Excel、图片(OCR)、音频及网页等多种格式转换为Markdown文本。提供CLI工具、Python API及批量转换脚本，适用于文档解析、内容提取与分析场景。

buddyMe/skill_library/skills/markitdown-skill-1.0.1/SKILL.md virgo777/buddyme

Trigger Scenarios

用户需要将文件（如PDF、Word）转换为Markdown格式用户需要提取网页或YouTube视频的文本内容用户需要进行图像文字识别(OCR)或音频转写用户需要批量处理多个文档并统一输出为Markdown

Install

npx skills add virgo777/buddyme --skill markitdown-skill -g -y

More Options

Non-standard path

npx skills add https://github.com/virgo777/buddyme/tree/master/buddyMe/skill_library/skills/markitdown-skill-1.0.1 -g -y

Use without installing

npx skills use virgo777/buddyme@markitdown-skill

指定 Agent (Claude Code)

npx skills add virgo777/buddyme --skill markitdown-skill -a claude-code -g -y

安装 repo 全部 skill

npx skills add virgo777/buddyme --all -g -y

预览 repo 内 skill

npx skills add virgo777/buddyme --list

SKILL.md

Frontmatter

{
    "name": "markitdown-skill",
    "metadata": {
        "openclaw": {
            "emoji": "📄",
            "install": [
                {
                    "id": "markitdown",
                    "bins": [
                        "markitdown"
                    ],
                    "kind": "pip",
                    "label": "Install MarkItDown CLI (pip)",
                    "package": "markitdown[all]"
                }
            ],
            "homepage": "https:\/\/github.com\/karmanverma\/markitdown-skill",
            "requires": {
                "bins": [
                    "python3",
                    "pip",
                    "markitdown"
                ]
            }
        }
    },
    "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."
}

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

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

# 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

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

markitdown-skill