markitdown

Convert documents, images, audio, and web content into Markdown.

564|70|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/ynulihao/AgentSkillOS --skill markitdown-ynulihao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/ynulihao/AgentSkillOS/tree/main/data/skill_seeds/markitdown
Command: npx skills add https://github.com/ynulihao/AgentSkillOS --skill markitdown-ynulihao

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the conversion of a wide variety of file formats into Markdown, making content easily digestible and processable by LLMs.

Core Features & Use Cases

  • Broad Format Support: Converts PDFs, DOCX, PPTX, XLSX, images (with OCR), audio (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs, and more.
  • LLM-Friendly Output: Generates token-efficient Markdown for seamless integration with language models.
  • AI-Enhanced Descriptions: Optionally adds AI-generated descriptions for images within documents.
  • Use Case: Convert a complex research paper in PDF format, including figures and tables, into a clean Markdown document for easier analysis and summarization by an AI.

Quick Start

Use the markitdown skill to convert the file 'report.pdf' into markdown format and save it as 'report.md'.

Frequently Asked Questions about markitdown

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

FAQPage Schema
How do I convert a PDF document to Markdown for LLM processing?

To convert a PDF to Markdown for LLM processing, you use an automated conversion tool that extracts text, tables, and figures into token-efficient Markdown. This process makes complex research papers easily digestible and processable by language models without manual formatting.

Can I extract text from images using OCR and save it as Markdown?

You can extract text from images using OCR and save it as Markdown by utilizing a file conversion tool with built-in OCR capabilities. This functionality digitizes visual content into text format, optionally adding AI-enhanced descriptions for the images during the conversion process.

How do I transcribe audio files into text format for language models?

Audio files are transcribed into text format for language models through automated transcription features within a file conversion utility. This mechanism directly processes audio content and outputs token-efficient Markdown, enabling seamless integration with LLMs for further text analysis.

What is the best way to convert web content and HTML into Markdown?

The best way to convert web content and HTML into Markdown is by using an automated conversion tool designed to parse diverse file formats. This approach transforms web pages and HTML structures into clean, LLM-friendly Markdown text for easier content analysis.

Does converting documents to Markdown support complex formats like XLSX and PPTX?

Converting documents to Markdown does support complex formats like XLSX and PPTX. The conversion mechanism processes diverse file formats, including spreadsheets and presentations, restructuring their content into token-efficient Markdown suitable for language model ingestion.

Are there limitations when converting ZIP files or YouTube URLs to Markdown?

When converting ZIP files or YouTube URLs to Markdown, the primary limitation is the dependency on the source content's structure. While the tool extracts and transcribes diverse formats, highly irregular web layouts or heavily nested ZIP archives may yield less structured Markdown output.