markitdown

Convert documents and media into structured Markdown text.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill turns complex documents into clean, LLM-friendly Markdown so you can read, search, and reuse their content without manual formatting work.

Core Features & Use Cases

  • Multi-format conversion to Markdown: Convert PDFs, DOCX, PPTX, spreadsheets, HTML, JSON/XML, CSV, images, audio, ZIP archives, EPUBs, and even YouTube URLs into Markdown for downstream analysis.
  • OCR and transcription support: Use OCR for scanned images/PDFs and transcription for audio inputs to produce usable text output.
  • Optional AI-enhanced image understanding: Generate detailed image/figure descriptions (useful for scientific figures and slides) via an LLM provider (e.g., OpenRouter) to improve fidelity for visual content.
  • Workflow-ready output: Produce Markdown that can be piped to files or processed in batch scripts for literature review pipelines and data extraction workflows.

Quick Start

Ask the AI to convert your file to Markdown by running: markitdown your_document.pdf -o output.md.

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 DOCX files to Markdown for literature review ingestion?

To convert PDFs and DOCX files to Markdown for literature review ingestion, use a Python-based conversion pipeline that detects file formats and outputs structured text. This process transforms documents into clean, LLM-friendly Markdown for downstream reading and analysis without manual formatting work.

Can I extract text from scanned PDFs and images using OCR?

Yes, you can extract text from scanned PDFs and images using built-in OCR support. The conversion pipeline applies OCR to scanned documents and images to produce usable text output, ensuring visual content is captured as structured Markdown.

What is the best way to transcribe audio files into Markdown text?

The best way to transcribe audio files into Markdown text is through a conversion pipeline with transcription support. It processes audio inputs directly, generating structured Markdown text that can be piped to files or processed in batch scripts for data extraction workflows.

Does this conversion pipeline support spreadsheets and PPTX slides?

Yes, the conversion pipeline supports spreadsheets and PPTX slides. It extracts data from spreadsheets and captures presentation notes from slides, converting them into structured Markdown text for downstream analysis and search.

How do I generate detailed descriptions for scientific figures and slides?

To generate detailed descriptions for scientific figures and slides, enable optional AI-enhanced image understanding via an LLM provider. This feature improves fidelity for visual content by producing descriptive text within the final Markdown output.

Can I convert YouTube URLs and ZIP archives into Markdown?

Yes, you can convert YouTube URLs and ZIP archives into Markdown. The pipeline supports URL ingestion and archive extraction, transforming diverse media file formats into clean, LLM-friendly Markdown text for downstream analysis.