steipete avatar

Markdown Converter

This wraps Microsoft's MarkItDown tool so you can convert documents, spreadsheets, presentations, and PDFs into Markdown without installing anything. It handles the usual suspects like Word, Excel, PowerPoint, plus images with OCR, audio transcription, and even YouTube URLs. The uvx runner means first use downloads dependencies but after that it's quick. Output quality depends on source formatting, and for gnarly PDFs you can point it at Azure Document Intelligence for better extraction. Good for when you need to process varied file types into a consistent format for documentation or analysis without maintaining a bunch of conversion libraries.

skills.sh installs
343
GitHub stars
7.5K
last updated
Aug 21, 2026

Install

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

Installs into .claude/skills of the current project.

Files

Markdown Converter

Convert files to Markdown using uvx --from "markitdown[all]" markitdown — no installation required.

Basic Usage

# Convert to stdout
uvx --from "markitdown[all]" markitdown input.pdf

# Save to file
uvx --from "markitdown[all]" markitdown input.pdf -o output.md
uvx --from "markitdown[all]" markitdown input.docx > output.md

# From stdin
cat input.pdf | uvx --from "markitdown[all]" 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 --from "markitdown[all]" markitdown report.docx -o report.md

Sponsors

Details

Repository
github.com/steipete/agent-scripts
Categories
Frontend Development, AI & Agent Building, Marketing & SEO, Office & Documents
First seen
Jun 3, 2026

More from steipete/agent-scripts

All 9
1krutikjain avatarandroid-compose-foundationskrutikjain/android-agent-skillsBuild Android UI with Jetpack Compose foundations, layouts, modifiers, theming, and stable component structure.340skills.sh installs
2dhruvanbhalara avatarflutter-debuggingdhruvanbhalara/skillsDebug and profile Flutter applications using DevTools, structured logging, and memory analysis. Use when diagnosing layout issues, tracking performance bottlene338skills.sh installs
3jezweb avatarvercel-blobjezweb/claude-skillsIntegrate Vercel Blob for file uploads and CDN-delivered assets in Next.js. Supports client-side uploads with presigned URLs and multipart transfers for large f333skills.sh installs
4bobmatnyc avatarvalidated-handlerbobmatnyc/claude-mpm-skillsType-safe API route handler with automatic Zod validation for Next.js App Router...332skills.sh installs
5tech-leads-club avatarperf-lighthousetech-leads-club/agent-skillsRun Lighthouse audits locally via CLI or Node API, parse and interpret reports, and set performance budgets. Use when measuring site performance, understanding 332skills.sh installs
6dirien avatarpulumi-typescriptdirien/claude-skillsScaffolds Pulumi TypeScript infrastructure-as-code projects, writes IaC code with proper resource configuration, manages Pulumi ESC environments for centralized329skills.sh installs