markitdown-skill SKILL.md skillA

markitdown-skill from ethanyoq/skill-hub is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ethanyoq/skill-hub/markitdown-skill@v1.0.1

Pins v1.0.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ethanyoq/skill-hub
Path
archives/user-installed-skills/markitdown-skill/1dbe0b6427269806/markitdown-skill/SKILL.md
Versions recorded
1
Latest version
v1.0.1, committed Sep 12, 2026
Size
3,646 bytes
Repository stars
11
License
MIT

Convert documents to Markdown using Microsoft's MarkItDown CLI (`markitdown`). Supports PDF, Word, PowerPoint, Excel, images (OCR), audio (transcription), HTML, YouTube, and URLs. Use when a user wants to convert a file or URL to Markdown, extract text from PDFs/images, transcribe audio/video, or batch-convert documents.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# MarkItDown Skill

Documentation and utilities for converting documents to Markdown using Microsoft's [MarkItDown](https://github.com/microsoft/markitdown) library.

> **Note:** This skill provides documentation and a batch script. The actual conversion is done by the `markitdown` CLI/library installed via pip.

## When to Use

**Use markitdown for:**
- 📄 Fetching documentation (README, API docs)
- 🌐 Converting web pages to markdown
- 📝 Document analysis (PDFs, Word, PowerPoint)
- 🎬 YouTube transcripts
- 🖼️ Image text extraction (OCR)
- 🎤 Audio transcription

## Quick Start

```bash
# Convert file to markdown
markitdown document.pdf -o output.md

# Convert URL
markitdown https://example.com/docs -o docs.md
```

## Supported Formats

| Format | Features |
|--------|----------|
| PDF | Text extraction, structure |
| Word (.docx) | Headings, lists, tables |
| PowerPoint | Slides, text |
| Excel | Tables, sheets |
| Images | OCR + EXIF metadata |
| Audio | Speech transcription |
| HTML | Structure preservation |
| YouTube | Video transcription |

## Installation

The skill requires Microsoft's `markitdown` CLI:

```bash
pip install 'markitdown[all]'
```
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ethanyoq/skill-hub/markitdown-skill@sha256:47aee272f21a1457

The line at the top of this page pins the label v1.0.1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_i2wpgyclr3thq7af.svg)](https://markdownregistry.com/a/art_i2wpgyclr3thq7af)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 12, 2026.

versioncommittedcommitsizeaudit
v1.0.1 latest2026-09-12 84c6c93 3,646 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3646 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ethanyoq/skill-hub · 11 stars · license MIT · pushed 2026-11-07 · branch mine

API

GET https://markdownregistry.com/api/v1/artifacts/art_i2wpgyclr3thq7af
GET https://markdownregistry.com/api/v1/resolve?ref=ethanyoq/skill-hub/markitdown-skill
GET https://markdownregistry.com/api/v1/blob/47aee272f21a1457a44bfb07fb6a715d4b6f41d16f642fa53eb655ef22468631

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ethanyoq/skill-hub

AGENTS.md AGENTS.md file
ethanyoq/skill-hub · AGENTS.md
git:20260730.c96ba6e · audit A · 11 stars
aact-bulk-trials SKILL.md skill
ethanyoq/skill-hub · archives/user-installed-skills/aact-bulk-trials/e07736f27453c7b6/aact-bulk-trials/SKILL.md · 使用 AACT (Aggregate Analysis of ClinicalTrials.gov) PostgreSQL 数据仓库进行批量、历史、聚合性临床试验数据挖掘。Use this skill when the user…
git:20260912.c74de71 · audit A · 11 stars
aact-bulk-trials SKILL.md skill
ethanyoq/skill-hub · archives/user-installed-skills/aact-bulk-trials/e171d39ba5bce7c9/aact-bulk-trials/SKILL.md · 使用 AACT (Aggregate Analysis of ClinicalTrials.gov) PostgreSQL 数据库进行大批量临床试验历史分析与数据挖掘。触发场景包括:AACT 查询、临床试验批量分析、PostgreSQL…
git:20260912.c74de71 · audit A · 11 stars
adaptive-quality-gate SKILL.md skill
ethanyoq/skill-hub · archives/user-installed-skills/adaptive-quality-gate/b5189ce6c1bdba9b/adaptive-quality-gate/SKILL.md · Use when work produces a deliverable, factual claim, dataset, code change, decision, publication, deployment…
git:20260912.c74de71 · audit A · 11 stars
add-changeset SKILL.md skill
ethanyoq/skill-hub · archives/user-installed-skills/add-changeset/eca9273317fbdf81/add-changeset/SKILL.md · Create a changeset file in .changeset/ that describes a user-facing change for the release notes
git:20260912.84c6c93 · audit A · 11 stars
add-competitor SKILL.md skill
ethanyoq/skill-hub · archives/user-installed-skills/add-competitor/72939df8cfcf87bc/add-competitor/SKILL.md · Add a new competitor to the AI Visibility Tool Directory — researches the tool, generates data, takes a screenshot, and…
git:20260912.84c6c93 · audit A · 11 stars
add-lang SKILL.md skill
ethanyoq/skill-hub · archives/user-installed-skills/add-lang/00700e7d79525f4e/add-lang/SKILL.md · Add tree-sitter language support to codegraph end-to-end — wire the grammar + extractor, write tests, then benchmark…
git:20260912.84c6c93 · audit A · 11 stars
aesthetic SKILL.md skill
ethanyoq/skill-hub · archives/user-installed-skills/aesthetic/a4c80565d9241341/aesthetic/SKILL.md · Create aesthetically beautiful interfaces following proven design principles. Use when building UI/UX, analyzing…
git:20260912.84c6c93 · audit A · 11 stars
agent-eval SKILL.md skill
ethanyoq/skill-hub · archives/user-installed-skills/agent-eval/61ca5bbbd5c736b7/agent-eval/SKILL.md · Benchmark CodeGraph retrieval quality on a real codebase by comparing agent behavior with vs without CodeGraph. Use…
git:20260912.84c6c93 · audit A · 11 stars
agent-reach SKILL.md skill
ethanyoq/skill-hub · archives/user-installed-skills/agent-reach/330e35da8cf10b5e/agent-reach/SKILL.md · MUST USE when user wants to 调研/research/搜索/search/查/找/look up anything on the internet — e.g. 全网调研 X / 帮我调研一下 X / 查一下 X…
git:20260912.84c6c93 · audit A · 11 stars
agent-reach SKILL.md skill
ethanyoq/skill-hub · archives/user-installed-skills/agent-reach/81c9cf0fc08ce044/agent-reach/SKILL.md · MUST USE when user wants to 调研/research/搜索/search/查/找/look up anything on the internet — e.g. 全网调研 X / 帮我调研一下 X / 查一下 X…
git:20260912.84c6c93 · audit A · 11 stars
aliyun-swas-manage SKILL.md skill
ethanyoq/skill-hub · archives/user-installed-skills/aliyun-swas-manage/1f89c6ea527741b3/aliyun-swas-manage/SKILL.md · Use when managing Alibaba Cloud Simple Application Server (SWAS OpenAPI 2020-06-01) resources end-to-end, including…
v1.0.0 · audit A · 11 stars

Every file in ethanyoq/skill-hub

Browse by kind, by grade A, or by owner.