markitdown

Convert PDFs, Office files, images, and web content into Markdown.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/Ocean326/Agents --skill markitdown-ocean326
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/Ocean326/Agents/tree/main/skills/global/markitdown
Command: npx skills add https://github.com/Ocean326/Agents --skill markitdown-ocean326

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markitdown, openai, requests, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

MarkItDown converts a wide range of file formats into Markdown, enabling easier content processing, sharing, and integration with LLM workflows.

Core Features & Use Cases

  • Convert PDFs, Word, PowerPoint, Excel, images with OCR, audio transcripts, HTML, CSV, JSON, XML, ZIPs, YouTube URLs, and eBooks to clean, token-efficient Markdown.
  • OCR and text extraction support for scanned documents and image-heavy content, with optional AI-assisted descriptions for visual material.
  • Flexible automation and scripting via Python, enabling batch conversions, literature workflows, and AI-enhanced transformations for scientific content.

Quick Start

Run the converter on a file by passing its path to MarkItDown to generate Markdown output.

Frequently Asked Questions about markitdown

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

FAQPage Schema
How do I convert PDF and Office documents to Markdown for AI workflows?

Convert PDFs, Word, PowerPoint, and Excel files to clean Markdown by passing the file path to the converter, streamlining content processing and ingestion by AI tools for research and editorial workflows.

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

OCR and text extraction support scanned documents and image-heavy content, offering optional AI-assisted descriptions for visual material to generate enhanced Markdown output.

Does the converter handle audio transcripts, YouTube URLs, and ZIP archives?

It transforms audio transcripts, media links like YouTube URLs, and ZIP archives into token-efficient Markdown, while also supporting HTML, CSV, JSON, XML, and eBooks for broad format coverage.

How do I batch convert multiple files to Markdown using Python?

Automate batch conversions and literature workflows via Python scripting, utilizing configurable scripts, references, and assets for flexible automation and AI-enhanced transformations.

Do I need external libraries or AI integrations to convert documents to Markdown?

Core conversion requires the MarkItDown library, while optional AI and Cloud integrations enable advanced features like AI-assisted image descriptions, with dependencies including openai and requests.