markitdown

Convert documents into Markdown files organized in a categorized Knowledgebase.

1|Updated May 13, 2026
One-click install
npx skills add https://github.com/coolrobertj/Agency-Cowork --skill markitdown-coolrobertj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/coolrobertj/Agency-Cowork/tree/main/skills/markitdown/skills/markitdown
Command: npx skills add https://github.com/coolrobertj/Agency-Cowork --skill markitdown-coolrobertj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markitdown, and includes scripts (resource) components.

What problem does it solve? Converting PDFs, Word documents, slide decks, and other files into Markdown for use as agent reference material is tedious and error-prone when done manually, and converted files often end up scattered without consistent organization. ## Core Features & Use Cases - Multi-Format Conversion: Convert PDF, Word, Excel, PowerPoint, HTML, images, audio, CSV, JSON, XML, ZIP, YouTube URLs, and EPubs into Markdown using the markitdown CLI. - Organized Knowledgebase Storage: Automatically place converted files into categorized folders such as Program, ExecutiveReviews, ProgramExecutionCouncil, Workstreams, and Specifications. - Naming and Overwrite Rules: Enforce kebab-case filenames, create workstream subfolders on demand, and confirm before overwriting existing files. - Use Case: Convert a monthly executive review PowerPoint into Markdown and store it under memory/Knowledgebase/ExecutiveReviews/ so the agent can reference it in future conversations. ## Quick Start Convert the attached Q3 executive review PowerPoint to Markdown and add it to the ExecutiveReviews folder in my Knowledgebase.

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 or Word document to Markdown?

Run the markitdown CLI with the input file and an output path, for example markitdown "report.pdf" -o "report.md". The skill routes output into the appropriate memory/Knowledgebase category folder with a kebab-case filename.

What file formats does markitdown support?

markitdown supports PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, images with EXIF and OCR, audio with transcription, CSV, JSON, XML, ZIP archives, YouTube URLs, and EPubs.

How do I install markitdown for document conversion?

Install it with pip using the command pip install 'markitdown[all]', which includes support for all formats. You can verify the installation by running markitdown --help.

Where are converted Markdown files stored?

Converted files are placed in memory/Knowledgebase/ under category folders such as Program, ExecutiveReviews, ProgramExecutionCouncil, Workstreams, and Specifications. If the category is ambiguous, the skill asks before choosing a folder.

What happens if a converted file already exists in the Knowledgebase?

The skill asks for confirmation before overwriting an existing file with the same name in the output location. It also never deletes the original source file after conversion.