Back to Skills

markitdown

Convert files and office documents to Markdown. Supports PDF, DOCX, PPTX, XLSX, images (with OCR), audio (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs and more.

17,798stars1,609forksUpdated 1/21/2026

Security Assessment

Critical Risk(0/100)

Detected risks:

Persistence([OPENROUTER_INTEGRATION.md] .zshrc, [OPENROUTER_INTEGRATION.md] .bashrc, [INSTALLATION_GUIDE.md] .bashrc)
Secret Exposure([OPENROUTER_INTEGRATION.md] API_KEY=, [OPENROUTER_INTEGRATION.md] api_key=, [SKILL.md] api_key=)
Sensitive File Access([OPENROUTER_INTEGRATION.md] .env)
Privilege Escalation([SKILL.md] sudo, [QUICK_REFERENCE.md] sudo, [INSTALLATION_GUIDE.md] sudo)
Security Score0/100

About markitdown

MarkItDown is a versatile Python tool developed by Microsoft that facilitates the conversion of various file formats into Markdown. This skill addresses the challenge of transforming complex documents, such as PDFs or Word files, into a clean and structured text format that is easy for Large Language Models (LLMs) to process. By converting files to Markdown, users can achieve a more token-efficient representation, making text handling more efficient for machine learning applications and natural language processing tasks.

FAQ

What file formats does MarkItDown support?

MarkItDown supports over 15 file formats including PDF, DOCX, PPTX, XLSX, images (with OCR), audio files (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube URLs, and EPUB.

Is there a command-line interface for using MarkItDown?

Yes, MarkItDown can be used via the command line for basic conversions, specifying output files, and enabling plugins.

Can I use MarkItDown in a Python application?

Absolutely! MarkItDown provides a Python API for integrating file conversion capabilities directly within your Python applications.

Are there any limitations on the types of files I can convert?

While MarkItDown supports a wide range of formats, specific features like OCR and transcription may have limitations based on file quality and content.

What is the license for MarkItDown?

MarkItDown is licensed under the MIT license, allowing for free use and modification.

All Files

7 files
OPENROUTER_INTEGRATION.md9.4 KB
View
SKILL.md12.3 KB
View
README.md4.9 KB
View
QUICK_REFERENCE.md6.7 KB
View
INSTALLATION_GUIDE.md6.6 KB
View
SKILL_SUMMARY.md8.4 KB
View
LICENSE.txt1.0 KB
View

Install markitdown

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill