markdown-converter
Converts documents, spreadsheets, and media into clean Markdown using markitdown.
Install
mkdir -p .claude/skills/markdown-converter && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/1695" && unzip -o skill.zip -d .claude/skills/markdown-converter && rm skill.zipInstalls to .claude/skills/markdown-converter
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.Key capabilities
- →Transform PDF/Office documents to Markdown
- →Extract data from CSV/Excel to MD tables
- →Transcribe audio into text documentation
- →Apply OCR for image-to-text conversion
How it works
Utilizes the markitdown library to iterate through binary structures and extract text and metadata into markdown syntax.
Inputs & outputs
When to use markdown-converter
- →Convert technical PDF documentation to Markdown
- →Extract data from Excel sheets to MD tables
- →Transcribe audio meetings into text
- →Process web page content into documentation
About this skill
Markdown Converter
Convert files to Markdown using uvx --from "markitdown[all]" markitdown — no installation required.
Basic Usage
# Convert to stdout
uvx --from "markitdown[all]" markitdown input.pdf
# Save to file
uvx --from "markitdown[all]" markitdown input.pdf -o output.md
uvx --from "markitdown[all]" markitdown input.docx > output.md
# From stdin
cat input.pdf | uvx --from "markitdown[all]" 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 --from "markitdown[all]" markitdown report.docx -o report.md
# Convert Excel spreadsheet
uvx --from "markitdown[all]" markitdown data.xlsx > data.md
# Convert PowerPoint presentation
uvx --from "markitdown[all]" markitdown slides.pptx -o slides.md
# Convert with file type hint (for stdin)
cat document | uvx --from "markitdown[all]" markitdown -x .pdf > output.md
# Use Azure Document Intelligence for better PDF extraction
uvx --from "markitdown[all]" 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
-dwith Azure Document Intelligence - If automatic charset detection picks the wrong encoding for a text file, pass
-c UTF-8(or the known charset)
When not to use it
- →Processing highly sensitive or private documents locally without caching
- →When original formatting fidelity is more important than structure
Prerequisites
Limitations
- →PDF table extraction quality varies
- →Dependency on external conversion plugins for complex formats
How it compares
It converts non-text formats into clean, structured markdown suitable for documentation, rather than just extracting raw text.
Compared to similar skills
markdown-converter side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| markdown-converter (this skill) | 5 | 4mo | Review | Beginner |
| report-writer | 1 | 7mo | No flags | Beginner |
| MinerU Document Extractor | 0 | 4mo | Review | Intermediate |
| document-pro | 0 | 5mo | No flags | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by steipete
View all by steipete →You might also like
report-writer
camel-ai
Generate professional reports from analysis results. Use when user needs to create formatted documents summarizing findings.
MinerU Document Extractor
opendatalab
>
document-pro
bighardperson
文档处理技能 - 让 AI 能够读取、解析、提取 PDF、DOCX、PPT 等文档的关键信息。当用户要求分析文档、提取内容、总结报告时触发此技能。
markitdown
K-Dense-AI
Convert various file formats (PDF, Office documents, images, audio, web content, structured data) to Markdown optimized for LLM processing. Use when converting documents to markdown, extracting text from PDFs/Office files, transcribing audio, performing OCR on images, extracting YouTube transcripts, or processing batches of files. Supports 20+ formats including DOCX, XLSX, PPTX, PDF, HTML, EPUB, CSV, JSON, images with OCR, and audio with transcription.
marker
benchflow-ai
Convert PDF documents to Markdown using marker_single. Use when Claude needs to extract text content from PDFs while preserving LaTeX formulas, equations, and document structure. Ideal for academic papers and technical documents containing mathematical notation.
enhance-claude-memory
avifenesh
Use when improving CLAUDE.md or AGENTS.md project memory files.