Convert various file formats (PDF, Office documents, images, audio, web content, structured data) to Markdown optimized for LLM processing.
SkillScore100Maintained
Automatic
◆Doc Ops pack
Last verified 8/24/2026
What it changes
Passed 23 of 23 test cases with the skill, and 13 of 23 without it.
Without skill57%
With skill100%
Checks it passed that the model alone missed
Passes 'config.json' to the convert method of MarkItDown.
Passes the full YouTube URL directly to the convert method.
Passes 'contract.docx' to the convert method of MarkItDown.
and 8 more in the full report
10 fixed13 passed either way0 still failing0 broke
Pass-rate lift
+43 pp
Tokens
+27%
Agent turns
0%
Response time
-59%
Model gemini-3.6-flashMeasured 8/24/2026v123 of 23 cases passed with skill
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 10 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 10
Prompt
I am writing a Python script to convert a complex PDF document into Markdown. I want to use Azure Document Intelligence to improve table layout extraction instead of the standard parser, but I am unsure which constructor parameters to supply when initializing the MarkItDown object. I already set up my environment with an endpoint URL 'https://myazure.cognitiveservices.azure.com' and an API key 'secret123'. Show how to instantiate the MarkItDown client using these credentials.
What was checked, without and with the skill
Checked
Without skill
With skill
Instantiates MarkItDown passing the endpoint via the docintel_endpoint keyword argument.
Missed
Passed
Supplies the API key credential using keyword arguments directly to the constructor.
Passed
Passed
case-07 · gemini-3.6-flash · 8/24/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md236 lines8 filesincludes scripts
MarkItDown
Overview
MarkItDown is a Python utility that converts various file formats into Markdown format, optimized for use with large language models and text analysis pipelines. It preserves document structure (headings, lists, tables, hyperlinks) while producing clean, token-efficient Markdown output.
When to Use This Skill
Use this skill when users request:
Converting documents to Markdown format
Extracting text from PDF, Word, PowerPoint, or Excel files
Performing OCR on images to extract text
Transcribing audio files to text
Extracting YouTube video transcripts
Processing HTML, EPUB, or web content to Markdown
Converting structured data (CSV, JSON, XML) to readable Markdown
Batch converting multiple files or ZIP archives
Preparing documents for LLM analysis or RAG systems
Core Capabilities
1. Document Conversion
Convert Office documents and PDFs to Markdown while preserving structure.
Supported formats:
PDF files (with optional Azure Document Intelligence integration)
Word documents (DOCX)
PowerPoint presentations (PPTX)
Excel spreadsheets (XLSX, XLS)
Basic usage:
from markitdown import MarkItDown
md = MarkItDown()
result = md.convert("document.pdf")
print(result.text_content)