Skip to main content
skill CX Codex

markitdown · jimmc414 — Claude Code skill: convert files to Markdown for LLMs

markitdown — a Claude Code skill that turns PDFs, Office documents, images, audio, and web pages into Markdown ready for language models. Handles 20+ formats while keeping headings, lists, tables, and links intact.

no license 1 installs ★ 607 updated 2026-10-09

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jimmc414/Kosmos --skill markitdown -a claude-code
Open on GitHub

What markitdown does

Built on the Python utility MarkItDown: feed it a file or URL, get back clean Markdown with no temporary files left behind.

Converts PDF, DOCX, PPTX, XLSX, HTML, EPUB, CSV, JSON, and XML. Images go through OCR with EXIF metadata pulled out; audio gets transcribed via the speech_recognition package. A YouTube link yields its transcript. ZIP archives are unpacked whole — every file inside is converted and concatenated into one result.

For tricky PDFs there's Azure Document Intelligence integration, which extracts tables and layout more accurately. You can also wire in GPT-4o to describe images inside presentations. The extension plugin system ships disabled by default for security and turns on with enable_plugins=True.

What it helps with

  • extract text from PDF or Office files
  • run OCR on images along with EXIF data
  • transcribe audio to text
  • pull YouTube transcripts from a URL
  • batch-convert documents for RAG or embedding pipelines

Example prompts for the agent

  • Convert manual.pdf to Markdown and save it as manual.md
  • Process every file in documents/ and write Markdown versions to markdown/
  • Unpack archive.zip and convert all PDFs inside to Markdown

How to install markitdown

1Skills CLI (Vercel)

npx skills add jimmc414/Kosmos --skill markitdown -a claude-code

2Manually: put the files in place

~/.claude/skills/markitdown/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/markitdown/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about markitdown

How do I install markitdown in Claude Code?

Run npx skills add jimmc414/Kosmos --skill markitdown -a claude-code. The skill lands in ~/.claude/skills/markitdown/SKILL.md.

What does markitdown do?

Converts PDFs, Office files, images, audio, HTML, and structured data into Markdown tuned for LLM consumption. Headings, lists, tables, and hyperlinks survive the conversion.

What do I need for audio transcription?

The speech_recognition package. For better table extraction from PDFs you need an Azure Document Intelligence endpoint and key; for GPT-4o image descriptions, an OpenAI client.

Similar skills

All skills for Agent setup: memory, context, orchestration →

markitdown by other authors comes first.

markitdown K-Dense-AI markitdown is a Claude Code skill that turns documents and selected URIs into Markdown for search, text analysis, and LLM/RAG ingestion. CX Codex +1 2,400installs markitdown julianobarbosa Teaches the agent to use Microsoft MarkItDown, turning PDFs, Office files, images and URLs into Markdown for LLM context. CX Codex +1 1,700installs pdf-to-markdown PSPDFKit-labs pdf-to-markdown turns a PDF into structured Markdown with headings, tables, lists and reading order intact. Handy when an agent needs the text of a document to work with. CX Codex +1 870installs markitdown-skill cjh-solver markitdown-skill is a Claude Code skill that converts documents and URLs to Markdown via the markitdown CLI. It extracts text from PDFs, runs OCR on images and transcribes audio files. CX Codex +1 ★ 108repo stars convert-pdf-to-md official github convert-pdf-to-md turns PDF files into Markdown text and extracts embedded images. Helps GitHub Copilot inspect documents, tables, and reports without manual copy-pasting. CX Codex +1 138installs mineru Nebutra mineru converts PDF, Office files, and images into clean Markdown with LaTeX math, tables, and OCR without requiring an API key up front. CX Codex +1 19installs PDF.co pdfdotco An MCP server for Claude Code, Codex, Cursor, Copilot, and other clients that run local servers over STDIO. It converts, merges, splits, searches, and fills PDFs through the PDF.co API. CX Codex +1 ★ 9repo stars doc-to-markdown daymade doc-to-markdown is a Claude Code skill that converts DOCX, PDF, PPTX, and saved HTML to Markdown with automated cleanup. It activates on prompts to convert or parse documents. CX Codex +1 945installs

From the same set2

Project sponsors

Companies that keep this analytics open