markitdown

Convert common document types into Markdown for LLM ingestion.

46|4|Updated Apr 8, 2023
One-click install
npx skills add https://github.com/CRAG666/dotfiles --skill markitdown-crag666
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/CRAG666/dotfiles/tree/main/skills/markitdown
Command: npx skills add https://github.com/CRAG666/dotfiles --skill markitdown-crag666

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill removes the manual effort of copying, cleaning, and reformatting documents by converting them directly into LLM-friendly Markdown that preserves structure as much as possible.

Core Features & Use Cases

  • Multi-format conversion to Markdown: Convert PDFs, Office files, images (with OCR), audio (with transcription), HTML, data formats, archives, and YouTube URLs into a single Markdown output format.
  • AI-enhanced image and slide descriptions: Enrich converted Markdown with detailed descriptions using OpenRouter-backed vision-capable LLMs for scientific figures and presentation content.
  • Use cases: Turn research papers into Markdown for literature review, extract tables from spreadsheets for analysis, and generate slide notes by converting PPTX plus AI descriptions for figures.

Quick Start

Convert a file to Markdown with AI image descriptions by running: markitdown document.pdf > output.md.

Frequently Asked Questions about markitdown

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

FAQPage Schema
How do I convert PDF and Office documents to Markdown for LLM ingestion?

You can convert PDFs and Office documents to Markdown by running a single command that transforms the original files into LLM-friendly text while preserving structural elements like headings and tables for immediate downstream reading.

Can I extract text from scanned images using OCR and output Markdown?

Yes, scanned images can be processed using built-in OCR capabilities to extract text and output a structured Markdown file, eliminating the need for manual transcription or external optical character recognition tools.

Does converting scientific literature to Markdown support AI image descriptions?

Yes, scientific literature conversion supports AI-enhanced image descriptions by configuring OpenRouter-backed vision-capable LLMs to generate detailed text explanations for complex figures within the Markdown output.

What's the best way to convert YouTube transcripts and audio files into Markdown?

The best way to convert YouTube transcripts and audio files is through stream-based conversion, which transcribes spoken content directly into structured Markdown text without manual audio editing or copy-pasting.

Do I need OpenAI dependencies to convert structured data formats like CSV and JSON?

No, you do not need OpenAI dependencies to convert structured data formats like CSV, JSON, or XML; the core conversion workflow processes these files natively into Markdown, requiring OpenAI only for optional AI-enhanced vision features.

How do I transform spreadsheets and presentation slides into Markdown for analysis?

You can transform spreadsheets and PPTX presentation slides into Markdown by running the conversion command, which extracts tabular data and slide notes while optionally enriching slide figures with AI-generated descriptions.