About

Imported from oimiragieo/agent-studio (.claude/skills/markitdown-converter/SKILL.md). Install upstream with npx skills add oimiragieo/agent-studio --skill markitdown-converter. Copyright stays with the author.

MarkItDown Converter Skill

Name: markitdown-converter
Author: oimiragieo

Convert files (PDF, DOCX, XLSX, PPTX, HTML, CSV, images, audio) to Markdown using Microsoft's MarkItDown library.

Usage

Skill({ skill: 'markitdown-converter' });
// Then call the converter via Bash:
// bash: python .claude/tools/cli/markitdown-convert.py <input_file> [output_file]

Supported File Types

Format	Extensions
Documents	.pdf, .docx, .pptx, .xlsx
Web	.html, .htm
Data	.csv, .json, .xml
Images	.jpg, .jpeg, .png, .gif, .webp
Audio	.mp3, .wav, .m4a
Archives	.zip (extracts and converts contents)
Video platforms	YouTube URLs

Installation

pip install 'markitdown[all]'

CLI Wrapper

The CLI wrapper is at .claude/tools/cli/markitdown-convert.py.

Convert a file to stdout

python .claude/tools/cli/markitdown-convert.py /path/to/file.pdf

Convert and save to output file

python .claude/tools/cli/markitdown-convert.py /path/to/file.pdf /path/to/output.md

Convert with explicit extension hint (for streams)

python .claude/tools/cli/markitdown-convert.py /path/to/file --ext .pdf

Exit Codes

Code	Meaning
0	Success — JSON with `text_content`
1	Conversion error
2	File not found
3	markitdown not installed

JSON Output Format

{
  "success": true,
  "text_content": "# Document Title\n\nContent here...",
  "char_count": 1234,
  "source_file": "report.pdf",
  "output_file": null
}

Integration with Telegram File Drop

When a user sends a file in Telegram:

// 1. Download the file to tmp
const tmpPath = `.claude/context/tmp/telegram-upload-${userId}-${Date.now()}.${ext}`;

// 2. Run markitdown converter
const result = JSON.parse(
  execSync(`python .claude/tools/cli/markitdown-convert.py "${tmpPath}"`).toString()
);

// 3. Store as agent memory
if (result.success) {
  MemoryRecord({ type: 'discovery', text: result.text_content.slice(0, 2000), area: 'user-files' });
}

Error Handling

// Check if markitdown is installed
const { status } = spawnSync('python', ['.claude/tools/cli/markitdown-convert.py', '--help']);
if (status === 3) {
  // Not installed — guide user
  sendMessage(chatId, 'File conversion requires: pip install markitdown[all]');
}

When to Use

User drops a file in Telegram → convert to markdown → store as memory
Agent needs to process uploaded documents
Convert research papers (PDF) to searchable markdown
Extract data from spreadsheets (XLSX → markdown tables)

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/oimiragieo-agent-studio-markitdown-converter/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

oimiragieo-agent-studio-markitdown-converter.ocm.jsonjson

{
  "ocm": "1",
  "id": "oimiragieo-agent-studio-markitdown-converter",
  "kind": "skill",
  "name": "markitdown-converter",
  "description": "Convert files to Markdown using Microsoft's MarkItDown library",
  "publisher": "oimiragieo",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "file-conversion",
      "markdown",
      "pdf",
      "docx",
      "xlsx",
      "images",
      "audio",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Convert files to Markdown using Microsoft's MarkItDown library"
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/oimiragieo/agent-studio",
      "path": ".claude/skills/markitdown-converter/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/oimiragieo/agent-studio/blob/HEAD/.claude/skills/markitdown-converter/SKILL.md",
      "key": "oimiragieo/agent-studio/.claude/skills/markitdown-converter/SKILL.md"
    }
  },
  "instructions": "# MarkItDown Converter Skill\n\nConvert files (PDF, DOCX, XLSX, PPTX, HTML, CSV, images, audio) to Markdown using Microsoft's MarkItDown library.\n\n## Usage\n\n```javascript\nSkill({ skill: 'markitdown-converter' });\n// Then call the converter via Bash:\n// bash: python .claude/tools/cli/markitdown-convert.py <input_file> [output_file]\n```\n\n## Supported File Types\n\n| Format          | Extensions                            |\n| --------------- | ------------------------------------- |\n| Documents       | .pdf, .docx, .pptx, .xlsx             |\n| Web             | .html, .htm                           |",
  "cost": {
    "context_tokens": 743
  }
}

Fetch it by URL: GET /api/v1/registry/oimiragieo-agent-studio-markitdown-converter/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.