microsoft-markitdown

Convert documents and web content into Markdown format.

Updated May 17, 2026
One-click install
npx skills add https://github.com/tiankong0101-byte/skills-registry --skill microsoft-markitdown
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: microsoft-markitdown
Source: https://github.com/tiankong0101-byte/skills-registry/tree/main/skills/microsoft-markitdown
Command: npx skills add https://github.com/tiankong0101-byte/skills-registry --skill microsoft-markitdown

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Microsoft MarkItDown removes the manual effort of copying text out of files and reformatting it into Markdown, making documents easier to edit, summarize, and reuse.

Core Features & Use Cases

  • Multi-format conversion: Convert PDFs, Word documents, PowerPoint decks, Excel spreadsheets, images, HTML, CSV, JSON, XML, ZIP archives, URLs, and YouTube content into Markdown.
  • Content preservation: Extract text, tables, and basic structure while optionally keeping image data as Base64 when needed.
  • Use Case: If you receive a PDF report or a webpage link, you can turn it into Markdown for note-taking, analysis, or downstream AI processing without manual transcription.

Quick Start

Use Microsoft MarkItDown to convert the attached file into Markdown and save the result as a .md file.

Frequently Asked Questions about microsoft-markitdown

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

FAQPage Schema
How do I convert a PDF to Markdown for editing and analysis?

Converting a PDF to Markdown extracts text, tables, and basic structure into an editable format. This allows you to transform static PDF reports into Markdown files for analysis, reuse, or downstream AI processing without manual transcription.

Can I extract tables from Office documents and save them as Markdown?

Yes, you can extract tables from Word documents, PowerPoint decks, and Excel spreadsheets. The conversion process preserves table structures and text, outputting them directly into Markdown format for immediate editing or data analysis workflows.

Does OCR work for converting images and scanned PDFs to Markdown?

OCR-assisted extraction allows you to convert images and scanned documents to Markdown. This feature extracts text from visual content, enabling you to digitize image-based reports into structured Markdown text for editing and analysis.

What is the best way to convert a webpage URL or YouTube transcript to Markdown?

The best way to convert webpages and YouTube content to Markdown is using an automated conversion tool that processes URLs directly. This method captures the webpage text and video transcripts, formatting them into Markdown for immediate note-taking or AI analysis.

How do I handle structured data like JSON, XML, or ZIP archives when converting to Markdown?

When converting structured data like JSON, XML, or ZIP archives to Markdown, the conversion tool parses and extracts the text content from these formats. It translates the structured data into readable Markdown, preserving the content for easier analysis and reuse.