AgentHubAgentHub

MarkItDown Skill Install & Guide

SkillClawHub

io.clawhub.jeminay/markitdown · v1.0.4

MarkItDown is a Python utility from Microsoft for converting various files (PDF, Word, Excel, PPTX, Images, Audio) to Markdown.

View on ClawHub ↗

Copy the install config on this page first, then verify docs and permissions upstream.

Popularity

Downloads2.6k
Installs86

Overview

MarkItDown is a Python utility from Microsoft for converting various files (PDF, Word, Excel, PPTX, Images, Audio) to Markdown. MarkItDown is a Agent Skill listed from ClawHub. This page includes an overview, setup tutorial, install commands, and use cases for Trae, Tongyi Lingma, Cursor, Claude Code, and VS Code.

AudioPDF

AgentHub Verified AvailabilityTested & Ready

Automated pipeline validated install commands, protocol & client compatibility

Verified At2026-06-29
Install Snippets TestedCLI & JSON config syntax verified
Protocol Handshake ReadyComplies with JSON-RPC 2.0 specifications
Origin Registry ActiveSourced from clawhub
Verified Clientsopenclaw、Claude Code、Claude Desktop 等
Security Tier: A 级 · 源码开放合规 (A)·Scanned for high-risk vulnerabilities. Recommended to run with project-scoped permissions.

Send this prompt to your AI to install the Skill

Recommended
Target client (auto-optimizes prompt):
PROMPT >

Follow the install guide at https://myagenthub.cn/install/skill.md?lang=en to automatically detect the current IDE and install the skill "jeminay/markitdown" without asking, and tell me how to verify it afterwards.

💡Paste into your AI coding assistant (Cursor, Trae, Claude Code) — the agent will handle download and configuration automatically.

Copy by platformAlternative

Choose your platform

Choose install method

Click to copy snippet
# 改 --ai 切换客户端：trae | lingma | workbuddy | kimi | qwen | cursor | claude-code | windsurf | cline | vscode | codex | openclaw
curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init jeminay/markitdown --ai cursor -y

Setup tutorial

  1. Open the MarkItDown page and confirm the source is ClawHub.
  2. Copy the install command for Trae, Lingma, Cursor, Claude Code, or universal CLI.
  3. Run it, or place SKILL.md under .trae/skills/, .lingma/skills/, or .cursor/skills/.
  4. Reload the client, then describe your task so the agent can match this skill.

Install commands

Install commands and setup steps are in the HTML so search engines and no-JS browsers can read them without running client JavaScript.

Universal — Skills CLI (recommended)

AgentHub CLI (change --ai)

# 改 --ai 切换客户端：trae | lingma | workbuddy | kimi | qwen | cursor | claude-code | windsurf | cline | vscode | codex | openclaw
curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init jeminay/markitdown --ai cursor -y

One-click API download

# 手动下载（Cursor 项目级示例）
mkdir -p .cursor/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d .cursor/skills/markitdown

Cursor

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init jeminay/markitdown --ai cursor -y

One-click API download

mkdir -p .cursor/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d .cursor/skills/markitdown

ClawHub CLI, then copy

# 在项目根目录执行 install
clawhub install jeminay/markitdown
mkdir -p .cursor/skills/markitdown
cp -R ./skills/markitdown/. .cursor/skills/markitdown/

# 源：./skills/markitdown/SKILL.md
# 目标：.cursor/skills/markitdown/SKILL.md

Trae (ByteDance)

  1. Trae natively supports Skill specs: project-level in .trae/skills/<name>/, global in ~/.trae/skills/
  2. Copy and run the command in your project terminal to download SKILL.md
  3. Reload Trae window, then describe your task in AI chat to activate automatically

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init jeminay/markitdown --ai trae -y

One-click API download

mkdir -p .trae/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d .trae/skills/markitdown

User directory

mkdir -p ~/.trae/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d ~/.trae/skills/markitdown

Tongyi Lingma (Alibaba)

  1. Tongyi Lingma supports skills in project .lingma/skills/<name>/ or global ~/.lingma/skills/
  2. Run the command to install SKILL.md
  3. In Lingma Agent mode, prompt your task and the skill will be automatically loaded

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init jeminay/markitdown --ai lingma -y

One-click API download

mkdir -p .lingma/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d .lingma/skills/markitdown

User directory

mkdir -p ~/.lingma/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d ~/.lingma/skills/markitdown

WorkBuddy / CodeBuddy (Tencent)

  1. WorkBuddy reads skills only from .workbuddy/skills/<name>/ (user-level ~/.workbuddy/skills/); .codebuddy/skills/ belongs to CodeBuddy
  2. The Skills CLI command installs with -a codebuddy and appends a copy step into .workbuddy/skills
  3. AgentHub CLI (--ai workbuddy) syncs it for you; reload the chat panel so the skill gets indexed

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init jeminay/markitdown --ai workbuddy -y

One-click API download

mkdir -p .workbuddy/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d .workbuddy/skills/markitdown

User directory

mkdir -p ~/.workbuddy/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d ~/.workbuddy/skills/markitdown

Claude Code

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init jeminay/markitdown --ai claude-code --global -y

One-click API download

mkdir -p ~/.claude/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d ~/.claude/skills/markitdown

ClawHub CLI, then copy

clawhub install jeminay/markitdown
mkdir -p ~/.claude/skills/markitdown
cp -R ./skills/markitdown/. ~/.claude/skills/markitdown/

# 源：./skills/markitdown/SKILL.md
# 目标：~/.claude/skills/markitdown/SKILL.md
# https://clawhub.ai/jeminay/markitdown

Kimi Code (Moonshot AI)

  1. Kimi Code supports standard Agent Skills: project-level in .agents/skills/<name>/, global in ~/.agents/skills/
  2. Run the command to install
  3. In Kimi Code CLI, describe your task to trigger the skill

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init jeminay/markitdown --ai kimi -y

One-click API download

mkdir -p .agents/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d .agents/skills/markitdown

User directory

mkdir -p ~/.agents/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d ~/.agents/skills/markitdown

Qwen Code (Alibaba)

  1. Qwen Code supports project .qwen/skills/<name>/ and global ~/.qwen/skills/
  2. Run the command to deploy SKILL.md
  3. Prompt the agent to trigger the skill

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init jeminay/markitdown --ai qwen -y

One-click API download

mkdir -p .qwen/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d .qwen/skills/markitdown

User directory

mkdir -p ~/.qwen/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d ~/.qwen/skills/markitdown

Windsurf

  1. Windsurf supports project-level .windsurf/skills/<name>/ or global ~/.codeium/windsurf/skills/
  2. Run the install command and refresh Cascade
  3. Cascade will auto-activate the skill based on its description

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init jeminay/markitdown --ai windsurf -y

One-click API download

mkdir -p .windsurf/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d .windsurf/skills/markitdown

User directory

mkdir -p ~/.codeium/windsurf/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d ~/.codeium/windsurf/skills/markitdown

Cline

  1. Cline supports standard .agents/skills/<name>/ structure
  2. Run the command to install the skill
  3. Ask questions in the Cline panel to trigger the skill

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init jeminay/markitdown --ai cline -y

One-click API download

mkdir -p .agents/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d .agents/skills/markitdown

Cherry Studio

  1. Use this skill as an Assistant system prompt in Cherry Studio
  2. Copy the command to view SKILL.md text
  3. Paste the contents into Cherry Studio Assistant system prompt
# 下载并提取 SKILL.md 指令内容
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -p /tmp/markitdown.zip SKILL.md
# 复制上述输出，粘贴至 Cherry Studio → 助手设置 →「系统提示词」

VS Code / GitHub Copilot

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init jeminay/markitdown --ai vscode -y

One-click API download

curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
mkdir -p .github/skills/markitdown
unzip -o /tmp/markitdown.zip -d .github/skills/markitdown

OpenAI Codex

AgentHub CLI (change --ai)

curl -fsSL "https://myagenthub.cn/cli/agenthub-skill.mjs" | node --input-type=module - init jeminay/markitdown --ai codex --global -y

One-click API download

mkdir -p ~/.codex/skills/markitdown
curl -sL "https://clawhub.ai/api/v1/download?slug=markitdown&version=1.0.4" -o /tmp/markitdown.zip
unzip -o /tmp/markitdown.zip -d ~/.codex/skills/markitdown

ClawHub CLI, then copy

clawhub install jeminay/markitdown
mkdir -p ~/.codex/skills/markitdown
cp -R ./skills/markitdown/. ~/.codex/skills/markitdown/

# 源：./skills/markitdown/SKILL.md
# 目标：~/.codex/skills/markitdown/SKILL.md

OpenClaw — ClawHub CLI

# OpenClaw / ClawHub CLI（推荐）
# 在项目根或 OpenClaw 工作区目录执行
clawhub install jeminay/markitdown

# 安装后 SKILL.md 位于：
#   ./skills/markitdown/SKILL.md
# （若已配置 OpenClaw 工作区，则在 <workspace>/skills/markitdown/）

# 仅查看不安装
clawhub inspect jeminay/markitdown

Troubleshooting & Common ErrorsFAQ

Common connection errors and verified fixes for MarkItDown

Getting 'connection closed' or exit code 1 in Cursor / Claude Code for MarkItDown?

Usually caused by missing runtime paths or IDE environment inheritance. Fix steps: 1. Verify Node.js 18+ (npx) or Python 3.10+ (uvx) is installed; 2. Run 'which npx' or 'which uvx' in terminal, and replace 'command' with absolute path; 3. Reload or restart the client window after modifying config.

Fix Snippet
# Check binary path in terminal:
which npx
node -v
Getting 'spawn npx ENOENT' or 'command not found'?

The editor background process does not inherit your full terminal PATH. Solution: Globally install the package, or set the absolute binary path (e.g. C:\Program Files\nodejs\npx.cmd on Windows, or /usr/local/bin/npx on macOS).

Tool calls timing out or failing to download packages?

First-time package downloading might be slow or timeout due to network limits. Configure a reliable mirror or check outbound proxy settings.

Agent does not match or apply MarkItDown during conversations?

Verify SKILL.md is located at .cursor/skills/MarkItDown/SKILL.md (Cursor) or ~/.claude/skills/MarkItDown/SKILL.md (Claude Code). You can explicitly mention the skill name in your prompt to boost match confidence.

Still not connecting? Read the MCP troubleshooting guide →

Tool Mock Playground

Sandbox

MarkItDown Rule Injection & Agent Behavior Simulation · Preview tool schema & outputs without local runtime

Sandbox Ready
fn: agent_skill_runtimeInject system prompt guidelines & workflow constraints from MarkItDown
Request ArgumentsJSON Schema
{
  "skill": "MarkItDown",
  "rulePath": ".cursor/skills/markitdown/SKILL.md",
  "userGoal": "请使用 MarkItDown 的方法与标准帮我完成当前任务",
  "client": "Cursor / Claude Code"
}
💡Parameters generated dynamically by Agent runtime
Agent Tool Output

Click 'Run Mock' above

to preview the raw response returned to the LLM

Env: AgentHub Virtual SandboxJSON-RPC 2.0

Decision Guide: Why & When to Use

Assess suitability before installing to save trial-and-error time

Best Suited For
  • When your AI Agent needs tool calling capabilities in this domain
  • Automating repetitive workflows in your IDE or terminal
  • Pairing with modern clients supporting MCP/Skill standards
When NOT to Use
  • When missing required API secrets or local runtime prerequisites
  • Pure conversational requests that don't need external system access
Recommended Workflow Pairing:

MarkItDown + Scenario Prompt → Complete Agent Automation

Skill hands-on: install to visible results

Follow the full lab (expected UI/output + contrast checks). After installing this item, verify with the tutorial prompts.

Open tutorial →

An Agent Skill is a folder with SKILL.md instructions. After install, the AI loads it automatically when your task matches its description.

How to use

After installing, describe your task in chat (or mention the skill name). The agent reads the skill description to decide when to activate it, then follows the instructions in SKILL.md. Check loaded skills via /skills in Claude Code or in your client settings.

Related resources

OpenMAIC

v0.3.11

SkillClawHub6.3k

io.clawhub.wyuc/openmaic

OpenMAIC assistant for setting up, generating, and extending OpenMAIC. Use when the user wants to use OpenMAIC, generate a multi-agent interactive classroom, or build on / extend / customize OpenMAIC and its @openmaic/* SDK (secondary development, 二开) — covers Live Demo or local setup, startup modes, provider keys, classroom generation, and secondary development (forking, providers/storage/themes, routes, or the renderer/editor).

source
View on ClawHub

media-use

v1.0.73

SkillClawHub4.5k

io.clawhub.heygen-com/media-use

Agent Media OS for a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal. When the host app provides its own music or sound-effect tools, use those for music and sound effects; `resolve --type bgm|sfx` needs the heygen CLI. When `HEYGEN_API_BASE` is set, HeyGen calls go through that host with no CLI sign-in.

source
View on ClawHub

x402 Compute

v1.31.0

SkillClawHub3.8k

io.clawhub.ivaavimusic/x402-compute

This skill should be used when the user asks to "provision GPU instance", "integrate agent pods over an API", "create pods for my customers", "pod webhooks", "pod events", "spin up a cloud server", "list compute plans", "browse GPU pricing", "deploy AI machine", "one-click GPU running an LLM", "deploy a private LLM endpoint", "OpenRouter-ready endpoint", "agent deploy GPU", "spin up my own OpenAI-compatible endpoint", "extend compute instance", "resize compute instance", "destroy server instance", "check instance status", "list my instances", "top up compute credits", "check credit balance", "run inference on the grid", "decentralized inference", "OpenAI-compatible API", "multimodal embeddings", "EmbeddingGemma 2", "embed image", "embed audio", "embed video", "mixed media vectors", "local embeddings", "confidential / TEE inference", "list grid models", "check grid capacity", "Laya", "System One", "Jev-compatible decisions", "typed decision model", "private Laya", "serve Laya from the node app", "run a node",

source
View on ClawHub

Planning with files

v3.23.0

SkillClawHub44.6k

io.clawhub.othmanadi/planning-with-files

Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; lifecycle hooks inject selected project planning context. Automatic recovery reads project planning files only. Explicit session-catchup.py --metadata reads same-project local agent session records and emits aggregate counts only; --replay may emit bounded nonce-framed excerpts. Optional gated mode can request continuation only when the host supports it and never runs commands declared in Markdown. The skill has no network upload path. Use for research or work needing 5+ tool calls.

source
View on ClawHub

Often paired with

Keep exploring AgentHub

Most people compare similar tools or check scenario guides before installing—start here.

Browse more like thisSearch similarPick by scenarioPrompt playbooksSkill hands-onReviews & comparisons

Listing badge: put AgentHub on your site

Copy either snippet into your project homepage, docs, or GitHub README. The badge is a hotlinked SVG — nothing to host — and it links back to this page so visitors can find the install steps.

PreviewListed on AgentHub: MarkItDown
HTML
<a href="https://myagenthub.cn/p/io.clawhub.jeminay/markitdown" title="Listed on AgentHub: MarkItDown" target="_blank" rel="noopener">
  <img src="https://myagenthub.cn/badge/io.clawhub.jeminay/markitdown?lang=en" alt="Listed on AgentHub: MarkItDown" height="20" style="border:0"/>
</a>
Markdown (GitHub README)
[![Listed on AgentHub: MarkItDown](https://myagenthub.cn/badge/io.clawhub.jeminay/markitdown?lang=en)](https://myagenthub.cn/p/io.clawhub.jeminay/markitdown)

Badges are generated on the fly from /badge/<package-id>, so name and listing changes propagate automatically. Keep the link target unchanged — it is what counts as the referral.

Unified Manifest

{
  "id": "io.clawhub.jeminay/markitdown",
  "type": "skill",
  "version": "1.0.4",
  "displayName": "MarkItDown",
  "description": "MarkItDown is a Python utility from Microsoft for converting various files (PDF, Word, Excel, PPTX, Images, Audio) to Markdown. Useful for extracting structu...",
  "author": {
    "name": "jeminay",
    "url": "https://clawhub.ai/jeminay"
  },
  "homepage": "https://clawhub.ai/jeminay/markitdown",
  "distribution": {
    "packages": [
      {
        "registryType": "source",
        "identifier": "jeminay/markitdown",
        "version": "1.0.4",
        "runtimeHint": "clawhub install"
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "openclaw",
    "claude-code",
    "claude-desktop",
    "cursor",
    "codex",
    "vscode"
  ],
  "keywords": [
    "downloads:2552",
    "stars:0",
    "installs:86",
    "Audio",
    "PDF"
  ],
  "provenance": {
    "origin": "clawhub",
    "originalId": "jeminay/markitdown",
    "originalUrl": "https://clawhub.ai/jeminay/markitdown",
    "isOfficial": false,
    "status": "active"
  }
}