This wraps Microsoft's markitdown tool so Claude can convert pretty much anything to Markdown without you installing dependencies. PDFs, Office docs, spreadsheets, presentations, images with OCR, even audio transcription and YouTube URLs. It uses uvx to run on demand, which means the first conversion caches things but after that it's fast. The real win is feeding messy formats into LLM context windows without manual copy-paste gymnastics. For stubborn PDFs, you can point it at Azure Document Intelligence for better extraction. Straightforward utility that does one thing well.

skills.sh installs
1.7K
GitHub stars
301
last updated
Aug 21, 2026

Install

$ npx -y skills add intellectronica/agent-skills --skill markdown-converter --agent claude-code

Installs into .claude/skills of the current project.

Files

Markdown Converter

Convert files to Markdown using uvx markitdown — no installation required.

Basic Usage

# Convert to stdout
uvx markitdown input.pdf

# Save to file
uvx markitdown input.pdf -o output.md
uvx markitdown input.docx > output.md

# From stdin
cat input.pdf | uvx markitdown

Supported Formats

  • Documents: PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls)
  • Web/Data: HTML, CSV, JSON, XML
  • Media: Images (EXIF + OCR), Audio (EXIF + transcription)
  • Other: ZIP (iterates contents), YouTube URLs, EPub

Options

-o OUTPUT      # Output file
-x EXTENSION   # Hint file extension (for stdin)
-m MIME_TYPE   # Hint MIME type
-c CHARSET     # Hint charset (e.g., UTF-8)
-d             # Use Azure Document Intelligence
-e ENDPOINT    # Document Intelligence endpoint
--use-plugins  # Enable 3rd-party plugins
--list-plugins # Show installed plugins

Examples

# Convert Word document
uvx markitdown report.docx -o report.md

# Convert Excel spreadsheet
uvx markitdown data.xlsx > data.md

# Convert PowerPoint presentation
uvx markitdown slides.pptx -o slides.md

Sponsors

Details

Repository
github.com/intellectronica/agent-skills
Categories
Frontend Development, Code Review & Quality, AI & Agent Building, Office & Documents

More from intellectronica/agent-skills

All 22
1nodeops-app avatarcreateosnodeops-app/skillsDeploy ANYTHING to production on CreateOS cloud platform. Use this skill when deploying, hosting, or shipping: (1) AI agents and multi-agent systems, (2) Backen1.7Kskills.sh installs
2mksglu avatarctx-upgrademksglu/context-modeUpdate context-mode from GitHub and fix hooks/settings. Pulls latest, builds, installs, updates npm global, configures hooks. Trigger: /context-mode:ctx-upgrade1.7Kskills.sh installs
3kostja94 avatargoogle-adskostja94/marketing-skillsWhen the user wants to set up, optimize, or manage Google Ads campaigns. Also use when the user mentions "Google Ads," "Google Search Ads," "PPC," "SEM," "PMF t1.7Kskills.sh installs
4kkkkhazix avatarstorage-analyzerkkkkhazix/khazix-skillsmacOS / Windows 只读存储分析助手(自动识别系统)。扫描整机磁盘占用,找出 占空间大户,把每一项分成 🟢可自动清理 / 🟡需人工判断 / 🔴谨慎清理 三级并给出 可执行处置方案,生成排版精美、可折叠、命令可一键复制的交互式 HTML 报告,并可 起本地服务在网页上一键删除(移废纸篓/直接删)。扫描全1.7Kskills.sh installs
5adobe avatarcontent-driven-developmentadobe/skillsApply a Content Driven Development process to AEM Edge Delivery Services development. Use for ALL code changes - new blocks, block modifications, CSS styling, b1.6Kskills.sh installs
6charleswiltgen avataraxiom-swiftuicharleswiltgen/axiomUse when building, fixing, or improving ANY SwiftUI UI — views, navigation, layout, animations, performance, architecture, gestures, debugging, iOS 26 features.1.6Kskills.sh installs