
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-codeInstalls 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