markitdown

Convert documents, images, audio, and URLs into Markdown.

2|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/coroboros/agent-skills --skill markitdown-coroboros
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/coroboros/agent-skills/tree/main/skills/markitdown
Command: npx skills add https://github.com/coroboros/agent-skills --skill markitdown-coroboros

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This tool converts documents, images, audio, and URLs into Markdown to make content readable, searchable, and easy to feed into AI workflows.

Core Features & Use Cases

  • Convert diverse inputs (PDF, DOCX, PPTX, HTML, images, audio, and YouTube transcripts) into clean Markdown for downstream analysis or summaries.
  • Save results to a structured path for reproducible pipelines or stream Markdown to the terminal for quick review.
  • Use in scenarios like preparing long reports, extracting notes from documents, or pre-processing content for context windows in language models.

Quick Start

Convert a file or URL to Markdown by invoking the markitdown CLI on your input.

Frequently Asked Questions about markitdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert PDFs and Word documents to Markdown?

You can convert documents like PDFs and Word files to Markdown by invoking the markitdown CLI on your input. It instantly transforms diverse formats into clean Markdown for downstream processing or easy reading.

Can I extract text from images and audio transcripts into Markdown?

Yes, you can extract text from images and audio transcripts into Markdown. The tool applies OCR and transcription logic to generate readable Markdown output from your media files.

Does this tool work with YouTube transcripts and HTML pages?

Yes, this tool works with YouTube transcripts and HTML pages. It accepts URLs as input and converts the content into structured Markdown suitable for downstream analysis or summaries.

What is the best way to save converted Markdown output to a file path?

The best way to save converted Markdown output is by using the save mode to write results to a structured path. This enables reproducible pipelines for your document conversion tasks.

Can I stream Markdown conversion results directly to the terminal?

Yes, you can stream Markdown conversion results directly to the terminal using the non-save mode. This allows for quick review of the extracted text without creating a persistent file.

Are there limitations when pre-processing large reports for language model context windows?

The tool pre-processes content for language model context windows by converting long reports to Markdown. Input validation and standardized RESULT reporting ensure integration, but output size depends on the source document length.