Skill

markdown-file

Convert local files (PDF, DOCX, PPTX, XLSX, etc.) to Markdown

Install

npx claudepluginhub pforret/cli-skills --plugin markdown-file

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Convert local files to Markdown using [markitdown](https://github.com/microsoft/markitdown) by Microsoft.

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.1k

claude-opus-4-5-migration

2 files

Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.

claude-opus-4-5-migration

83.2k

smart-explore

Performs token-optimized structural code search using tree-sitter AST parsing to discover symbols, outline files, and unfold code without reading full files.

claude-mem

65.8k

Stats

Parent Repo Stars0

Parent Repo Forks0

Last CommitApr 2, 2026

Actions

View Source View Plugin View on GitHub View README

markdown-file

Convert local files to Markdown using markitdown by Microsoft.

Plugin root: this SKILL.md is at skills/markdown-file/SKILL.md inside the plugin. All paths below are relative to the plugin root (two directories up from this file). Resolve them from this file's location before running.

Setup

Run once before first use:

bash <plugin-root>/setup.sh

Supported formats

PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx), HTML, CSV, JSON, XML, images (EXIF/OCR), audio (transcription), EPUB, ZIP archives.

Usage

<plugin-root>/.venv/bin/markitdown <input-file> -o <output.md>

Or pipe to stdout:

<plugin-root>/.venv/bin/markitdown <input-file>

Examples

<plugin-root>/.venv/bin/markitdown report.pdf -o report.md
<plugin-root>/.venv/bin/markitdown slides.pptx -o slides.md
<plugin-root>/.venv/bin/markitdown data.xlsx -o data.md
<plugin-root>/.venv/bin/markitdown photo.jpg -o photo.md

Docker alternative

No Python/venv needed — just Docker:

bash <plugin-root>/run.sh report.pdf -o report.md

The run.sh wrapper auto-detects: uses Docker if available (builds image on first run), falls back to venv. You can also run Docker directly:

docker run --rm -v "$(pwd):/work" cliskills/markdown-file report.pdf -o report.md

Build the image once with: docker build -t cliskills/markdown-file <plugin-root>/

How Claude Code should use this skill

Determine PLUGIN_ROOT by resolving ../.. from this SKILL.md file's path
Preferred: use bash $PLUGIN_ROOT/run.sh <input> [options] — auto-detects Docker or venv
Fallback: ensure setup has been run (bash $PLUGIN_ROOT/setup.sh) and use $PLUGIN_ROOT/.venv/bin/markitdown directly
Read the resulting .md if the user wants to see the content

Do NOT use this skill for URLs — use markdown-web instead.

Requires Python 3.10+ (venv mode) or Docker.