How do I install markdown-converter?

Run `npx skills add https://github.com/intellectronica/agent-skills --skill markdown-converter` in your terminal. You need to have run `npx skills init` once in your project first.

Which agent frameworks does markdown-converter support?

markdown-converter works with any agent framework supported by the Skills registry, including Claude Code, Cursor, GitHub Copilot, Cline, Codex, and Gemini CLI.

Is markdown-converter free to use?

Yes. markdown-converter is free to install and use. It is available from the open Skills registry published by intellectronica.

Productivity

markdown-converter▌

Name: markdown-converter
Availability: InStock
Author: intellectronica

intellectronica/agent-skills · updated Apr 8, 2026

$npx skills add https://github.com/intellectronica/agent-skills --skill markdown-converter

summary

Convert documents, spreadsheets, presentations, images, audio, and web content to Markdown for LLM processing.

›Supports 15+ formats including PDF, Word, PowerPoint, Excel, HTML, CSV, JSON, XML, images with OCR, audio with transcription, ZIP archives, YouTube URLs, and EPub
›Preserves document structure including headings, tables, lists, and links in the converted Markdown output
›Optional Azure Document Intelligence integration ( -d flag) for improved extraction on complex or scanned P

skill.md

Markdown Converter

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

Basic Usage

# 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

-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

# 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