markdown-converter

---
name: markdown-converter
description: "Use when working with markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube from steipete/agent-scripts."
source: https://github.com/steipete/agent-scripts/tree/main/skills/markdown-converter
generated: 2026-05-27T20:55:56.680Z
category: tool
audience: engineers
---

## When to use

- Using the markdown-converter skill's upstream workflow, guardrails, and local-tool assumptions.
- Auditing commands or operational steps before changing markdown converter behavior.
- Needing a compact agent reference for markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

## Key concepts

### Basic Usage

Basic Usage guidance for the markdown-converter skill.

### 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

Options guidance for the markdown-converter skill.

### Examples

Examples guidance for the markdown-converter skill.

### 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.

## API reference

```
npx skills add steipete/agent-scripts --skill markdown-converter
```

Install the markdown-converter skill from steipete/agent-scripts.

```
npx skills add steipete/agent-scripts --skill markdown-converter
```

```
uvx markitdown input.pdf.
```

Command or snippet documented by the upstream markdown-converter skill.

```
# 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
```

```
-o OUTPUT # Output file.
```

Command or snippet documented by the upstream markdown-converter skill.

```
-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
```

```
uvx markitdown report.docx -o report.md.
```

Command or snippet documented by the upstream markdown-converter skill.

```
# 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/"
```

## Gotchas

- Read the upstream SKILL.md before use; several entries encode machine-specific paths, credentials, or local operational assumptions.

---
Generated by SkillMake from https://github.com/steipete/agent-scripts/tree/main/skills/markdown-converter on 2026-05-27T20:55:56.680Z.
Verify against source before relying on details.

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