Agent skill · software engineering · k-dense-ai
markitdown
Convert heterogeneous documents and selected URIs to Markdown with Microsoft MarkItDown for text analysis, search, and LLM/RAG ingestion. Covers safe local conversion, streams, Office/PDF/data formats, batch workflows, plugins, vision OCR, Azure extraction, and the official MCP server.
Why this skill is useful
Adds specific commands and workflows for converting various document formats to Markdown that the AI wouldn't reliably generate on its own.
What it needs
Requires markitdown, uv installed locally. About 6k tokens when loaded. Last updated 2026-08-03. 32,849 stars on the source repository.
What this skill does
MarkItDown Overview MarkItDown is Microsoft's lightweight Python utility for turning common documents into structure-preserving Markdown. Its output is designed primarily for indexing, text analysis, search, and LLM ingestion—not high-fidelity visual reproduction. This skill targets MarkItDown 0.1.6, released May 26, 2026. New code should use result.markdown; result.textcontent remains only as a soft-deprecated compatibility alias. Choose the Right Path Need Recommended path --- --- Trusted local PDF, Office, HTML, CSV, EPUB, or ZIP Built-in converter with convertlocal() Uploaded bytes or an already-open file convertstream() with StreamInfo hints Remote HTTP(S) input Validate and fetch it yourself, then call convertresponse() Scanned PDF or text inside embedded images Official markitdown-ocr vision plugin, Azure Document Intelligence, or Azure Content Understanding Video, structured fields, or custom multimodal extraction Azure Content Understanding Local agent integration Official markitdown-mcp server over STDIO or localhost Bounding boxes, page coordinates, or screenshots Use a layout-aware parser such as LiteParse instead PDF merge/split/forms/watermarks Use the pdf skill instead Installation Create an isolated environment: Install every built-in feature: Or install only the converters required by the task: Available extras in 0.1.6 are: pptx, docx, xlsx, xls, pdf, and outlook audio-transcription and youtube-transcription az-doc-intel and az-content-understanding all Verify the installation: The [all] extra does not install the separate markitdown-ocr plugin or an OpenAI-compatible client. Quick Start Command line Useful CLI controls: --keep-data-uris can make output very large and may preserve embedded sensitive data. Enable it only when required. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills k-dense-ai/markitdown