skill CX Codex

markdown-converter · intellectronica — Claude Code skill: what it does, how to install

Q: How to install markdown-converter in Claude Code?

Run `npx skills add intellectronica/agent-skills --skill markdown-converter -a claude-code` in your terminal.

Q: How does it handle complex PDF scans?

You can enable Azure Document Intelligence by passing the `-d` flag along with your service endpoint using `-e`.

Converts documents, spreadsheets, and media files to Markdown via markitdown. Prepares data for LLM processing while preserving headings and tables.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add intellectronica/agent-skills --skill markdown-converter -a claude-code

Open on GitHub

What markdown-converter does

The skill converts various file formats into Markdown by running uvx markitdown. It supports PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XML, EPub books, and ZIP archives. It also extracts text from images via OCR and transcribes audio files while reading EXIF metadata.

Conversion preserves document structure including headings, tables, bullet lists, and links. Output can be printed directly, piped through standard input, or written to disk with -o.

The runner requires uvx available in your environment. If complex scanned PDFs fail to extract properly, pass -d with an Azure Document Intelligence endpoint via -e.

What it helps with

convert Word documents and PowerPoint slides to clean Markdown
extract tables and structure from Excel sheets for LLM analysis
run OCR on images to pull out text alongside EXIF data
transcribe audio files into structured Markdown notes

Example prompts for the agent

Convert report.docx to Markdown and save it as report.md.
Turn the data.xlsx spreadsheet into Markdown.
Extract text from scan.pdf using Azure Document Intelligence.

How to install markdown-converter

1Skills CLI (Vercel)

npx skills add intellectronica/agent-skills --skill markdown-converter -a claude-code

2Manually: put the files in place

~/.claude/skills/markdown-converter/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/markdown-converter/

1Skills CLI (Vercel)

npx skills add intellectronica/agent-skills --skill markdown-converter -a codex

2Manually: put the files in place

.agents/skills/markdown-converter/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add intellectronica/agent-skills --skill markdown-converter -a cursor

2Manually: put the files in place

.cursor/skills/markdown-converter/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install intellectronica/agent-skills markdown-converter

2Manually: put the files in place

.github/skills/markdown-converter/SKILL.md

1Skills CLI (Vercel)

npx skills add intellectronica/agent-skills --skill markdown-converter -a gemini-cli

2Platform CLI

gemini skills install https://github.com/intellectronica/agent-skills --path skills/markdown-converter

Manually: put the files in place

.devin/skills/markdown-converter/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add intellectronica/agent-skills --skill markdown-converter -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about markdown-converter

How to install markdown-converter in Claude Code?

Run npx skills add intellectronica/agent-skills --skill markdown-converter -a claude-code in your terminal.

What does markdown-converter do?

It converts files like PDF, Word, Excel, audio, and images into Markdown using markitdown executed through uvx.

How does it handle complex PDF scans?

You can enable Azure Document Intelligence by passing the -d flag along with your service endpoint using -e.

Source text

SKILL.md · CC0-1.0

---
name: markdown-converter
description: Convert documents and files to Markdown using markitdown. Use when converting PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XML, images (with EXIF/OCR), audio (with transcription), ZIP archives, YouTube URLs, or EPubs to Markdown format for LLM processing or text analysis.
---

# Markdown Converter

Convert files to Markdown using `uvx markitdown` — no installation required.

## Basic Usage

```bash
# Convert to stdout
uvx markitdown input.pdf

# Save to file
uvx markitdown input.pdf -o output.md
uvx markitdown input.docx > output.md

# From stdin
cat input.pdf | uvx markitdown
```

## Supported Formats

- **Documents**: PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls)
- **Web/Data**: HTML, CSV, JSON, XML
- **Media**: Images (EXIF + OCR), Audio (EXIF + transcription)
- **Other**: ZIP (iterates contents), YouTube URLs, EPub

## Options

```bash
-o OUTPUT      # Output file
-x EXTENSION   # Hint file extension (for stdin)
-m MIME_TYPE   # Hint MIME type
-c CHARSET     # Hint charset (e.g., UTF-8)
-d             # Use Azure Document Intelligence
-e ENDPOINT    # Document Intelligence endpoint
--use-plugins  # Enable 3rd-party plugins
--list-plugins # Show installed plugins
```

## Examples

```bash
# Convert Word document
uvx markitdown report.docx -o report.md

# Convert Excel spreadsheet
uvx markitdown data.xlsx > data.md

# Convert PowerPoint presentation
uvx markitdown slides.pptx -o slides.md

# Convert with file type hint (for stdin)
cat document | uvx markitdown -x .pdf > output.md

# Use Azure Document Intelligence for better PDF extraction
uvx markitdown scan.pdf -d -e "https://your-resource.cognitiveservices.azure.com/"
```

## Notes

- Output preserves document structure: headings, tables, lists, links
- First run caches dependencies; subsequent runs are faster
- For complex PDFs with poor extraction, use `-d` with Azure Document Intelligence

Similar skills

Everything for Office documents →

markdown-converter by other authors comes first.

markdown-converter steipete Converts documents, spreadsheets, PDF, media, and structured data into Markdown via uvx without manual parser setup. CX Codex +1 339installs pptx official anthropics This skill helps create, read, and edit .pptx files and .potx templates. Use it when building a deck or extracting slide text. 241,433installs pdf official anthropics This skill lets an agent read, create, and edit PDF files, including forms and scanned documents. Use it when PDF work is part of the task. 216,041installs docx official anthropics This skill creates, reads, and edits Word documents and templates. Use it for reports, letters, and files that need headings, tables, or page numbers. 206,304installs xlsx official anthropics Creates, reads, edits, and converts spreadsheet files. Use it when the requested deliverable is an Excel workbook or another tabular file. 187,223installs brand-guidelines official anthropics Applies Anthropic's official brand colors and fonts to documents, slides and other artifacts. Useful whenever something needs to match the company look. 109,043installs theme-factory official anthropics Applies preset color palettes and font pairs to slides, documents, and HTML pages. Use it when an artifact needs one consistent visual style. 94,921installs

From the same set20

nano-banana-pro Generates and modifies images using Google's Gemini 3 Pro Image API. Handy when you need quick illustrations or visual edits directly from your coding session. CX Codex +1 3,200installs ultrathink The skill displays colorful ANSI art of the word "ultrathink" in the terminal. It triggers on the word itself or via /ultrathink. CX Codex +1 1,900installs beautiful-mermaid Renders Mermaid diagrams into SVG and PNG formats using the Beautiful Mermaid library. Useful when the agent needs visual architecture diagrams, workflows, or data models. CX Codex +1 1,800installs todoist-api This skill tells the agent how to drive Todoist through the td CLI: tasks, projects, sections, labels and comments. Handy when you want your lists sorted without leaving the chat. CX Codex +1 1,700installs anki-connect Connects AI agents to the Anki desktop app via the local AnkiConnect API. It helps inspect decks, search cards, and manage notes. CX Codex +1 891installs nano-banana-2 A skill that drives the Nano Banana 2 API to generate and edit images, with control over resolution and aspect ratio. CX Codex +1 869installs gog-cli Teaches AI agents to operate Google Workspace via the gog CLI for Gmail, Calendar, Drive, and Docs workflows. CX Codex +1 807installs promptify Transforms brief user requests into clear markdown specifications for AI models without conversational filler or introductory commentary. CX Codex +1 643installs