markitdown-python

Convert PDFs, Office files, images, and URLs into Markdown.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the hassle of manually converting PDFs, Office documents, and other media into usable text by turning them directly into Markdown.

Core Features & Use Cases

  • Multi-format to Markdown conversion: Convert PDFs, Word, PowerPoint, Excel, images, HTML, CSV/JSON/XML, EPUBs, ZIP archives, YouTube URLs, and Outlook .msg files into Markdown.
  • Supports deep extraction: Extract text content from documents and process media files, including audio-related transcription workflows when configured.
  • LLM-assisted image descriptions: Use an LLM client to produce richer text from images during conversion.

Quick Start

Ask the agent to convert your document to Markdown by running markitdown on the file path, then saving the output to an .md file for immediate use.

Frequently Asked Questions about markitdown-python

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

FAQPage Schema
How do I convert PDF to Markdown without manual formatting?

To convert PDF to Markdown, you can run a document extraction tool on the file path and save the output directly as an .md file. This eliminates manual copying and formatting of document content.

Can I extract text from Office files and YouTube transcripts into Markdown?

Yes, document extraction supports converting Word, PowerPoint, Excel files, and YouTube URLs into readable Markdown by processing the inputs through the command-line or Python API.

What file formats are supported for Markdown conversion?

Markdown conversion supports PDFs, Office documents, images, HTML, CSV, JSON, XML, EPUBs, ZIP archives, and Outlook .msg files, turning them directly into usable text.

Do I need a local installation to convert documents to Markdown?

Yes, document to Markdown conversion requires a local MarkItDown installation with optional venv PATH setup to execute conversions via command-line or Python API.

How does image to Markdown conversion handle visual content?

Image to Markdown conversion can produce richer text descriptions by using an LLM client during the extraction process, generating readable text directly from the visual content.