feat(markitdown): add markitdown plugin to marketplace

.claude-plugin/marketplace.json

@@ -356,6 +356,14 @@
       "keywords": ["worktree", "git", "isolation", "safety"],
       "tags": ["tooling", "safety"],
       "source": "./plugins/worktree"
+    },
+    {
+      "name": "markitdown",
+      "description": "Convert documents (PDF, DOCX, PPTX, images, etc.) to Markdown using MarkItDown MCP server",
+      "category": "tooling",
+      "keywords": ["markitdown", "pdf", "docx", "pptx", "markdown", "conversion", "images"],
+      "tags": ["mcp", "conversion"],
+      "source": "./plugins/markitdown"
     }
   ]
 }

CLAUDE.md

@@ -441,6 +441,20 @@ bun run test
 bun run typecheck
 ```
 
+## Plugin Validation
+
+Validate a plugin manifest or marketplace manifest using the Claude CLI:
+
+```bash
+# Validate a plugin
+claude plugin validate <path-to-plugin-dir>
+
+# Validate marketplace manifest
+claude plugin validate .claude-plugin/marketplace.json
+```
+
+Run this before committing new plugins or after modifying `plugin.json`.
+
 ## Key Files
 
 - `.claude-plugin/marketplace.json` - Marketplace configuration and plugin registry

README.md

@@ -207,6 +207,11 @@ Git worktree isolation: injects context at session start and blocks file access
 
 **Install:** `/plugin install worktree@pleaseai` | **Source:** [plugins/worktree](https://github.com/pleaseai/claude-code-plugins/tree/main/plugins/worktree)
 
+#### MarkItDown
+Convert documents (PDF, DOCX, PPTX, images, etc.) to Markdown using Microsoft's MarkItDown MCP server.
+
+**Install:** `/plugin install markitdown@pleaseai` | **Source:** [plugins/markitdown](https://github.com/pleaseai/claude-code-plugins/tree/main/plugins/markitdown)
+
 ## Installation
 
 ### Add This Marketplace
@@ -260,6 +265,7 @@ Once the marketplace is added, install any plugin with:
 /plugin install slack-agent@pleaseai
 /plugin install mcp-neo4j@pleaseai
 /plugin install worktree@pleaseai
+/plugin install markitdown@pleaseai
 ```
 
 ## What Are Claude Code Plugins?

plugins/markitdown/.claude-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "markitdown",
+  "version": "1.0.0",
+  "description": "Convert documents (PDF, DOCX, PPTX, images, etc.) to Markdown using MarkItDown MCP server",
+  "author": {
+    "name": "Microsoft",
+    "url": "https://github.com/microsoft"
+  },
+  "homepage": "https://github.com/microsoft/markitdown",
+  "repository": "https://github.com/microsoft/markitdown",
+  "license": "MIT",
+  "keywords": ["markitdown", "pdf", "docx", "pptx", "images", "markdown", "conversion"],
+  "mcpServers": {
+    "markitdown": {
+      "command": "uvx",
+      "args": ["markitdown-mcp"]
+    }
+  }
+}

plugins/markitdown/hooks/check-binary-doc.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+set -euo pipefail
+
+input=$(cat)
+file_path=$(echo "$input" | jq -r '.tool_input.file_path // ""')
+ext="${file_path##*.}"
+ext_lower=$(echo "$ext" | tr '[:upper:]' '[:lower:]')
+
+case "$ext_lower" in
+  pptx|docx|xlsx|xls|ppt|doc)
+    message="WARNING: This file is a binary document format (.${ext_lower}) that the Read tool cannot parse properly — it will return garbled binary data. Use the markitdown MCP tool instead: call mcp__markitdown__convert_to_markdown with uri=\"file://${file_path}\"."
+    jq -n --arg msg "$message" '{hookSpecificOutput:{permissionDecision:"allow",additionalContext:$msg}}'
+    ;;
+  *)
+    echo '{}'
+    ;;
+esac

plugins/markitdown/hooks/hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/check-binary-doc.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}