markitdown

Convert PDF, Word, PowerPoint, and HTML documents into Markdown with YAML frontmatter.

3|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/JunMA98/Computer-science-claude-skills --skill markitdown-junma98
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/JunMA98/Computer-science-claude-skills/tree/main/skills/markitdown
Command: npx skills add https://github.com/JunMA98/Computer-science-claude-skills --skill markitdown-junma98

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Turning diverse CS documents (papers, slides, reports, and project notes) into clean, searchable Markdown to streamline literature reviews, code documentation, and release preparation.

Core Features & Use Cases

  • Converts PDFs, Word, PowerPoint, HTML, and other formats into Markdown while preserving tables, lists, and code blocks.
  • Produces a YAML frontmatter header for discovery, with title and key metadata, and a rich Markdown body for downstream tasks.
  • Optional resources (scripts/, references/, assets/) support batch workflows, documentation extraction, and example usage.
  • Real-world use cases include literature review, paper drafting, experiment documentation, and repository cleanup.

Quick Start

Provide a source document (PDF, DOCX, PPTX, or HTML) and request a Markdown conversion to obtain a Markdown file with frontmatter and content ready for AI context loading.

Frequently Asked Questions about markitdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert PDFs and PowerPoint slides into Markdown for research workflows?

To convert PDFs and PPTX slides into Markdown, the skill processes source documents while preserving tables, lists, and code blocks. It outputs a Markdown body with YAML frontmatter, directly ready for literature reviews and AI context loading.

Does this tool support converting Word documents and HTML files into clean Markdown?

Yes, converting Word documents and HTML files into clean Markdown is fully supported. The conversion maintains structural elements like lists and code blocks, producing a searchable Markdown file complete with metadata frontmatter for downstream engineering tasks.

What is the best way to prepare research papers for AI context loading using Markdown?

The best way to prepare research papers for AI context loading is converting them into structured Markdown. This skill generates a rich Markdown body with YAML frontmatter containing the title and description, optimizing the text for large language model ingestion.

Can I automate documentation extraction for repository cleanup and release preparation?

Yes, you can automate documentation extraction for repository cleanup. By utilizing the optional scripts, references, and assets folders, the skill supports batch workflows to extract reusable Markdown from diverse reports and project notes for release prep.

What formats are supported when converting documents into Markdown for literature reviews?

Supported formats for converting documents into Markdown include PDF, DOCX, PPTX, and HTML. The conversion preserves structural integrity like tables and lists, yielding reusable Markdown outputs tailored for literature reviews and coding experiments.