Markdown Converter
- 1.5k installs
- 279 repo stars
- Updated April 25, 2026
- intellectronica/agent-skills
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 tran
About
The markdown converter skill 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. Documentation covers workflows, commands, and guardrails agents should follow when users invoke this capability. Key documented areas include **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. Reference commands include uvx markitdown input.pdf; uvx markitdown input.pdf -o output.md. Use when developers or agents need structured guidance for markdown converter tasks with evidence grounded in the bundled SKILL.md rather than generic advice.
- **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
- Output preserves document structure: headings, tables, lists, links
Markdown Converter by the numbers
- 1,529 all-time installs (skills.sh)
- +16 installs in the week ending Jul 28, 2026 (Skillselion tracking)
- Ranked #127 of 690 Office & Documents skills by installs in the Skillselion catalog
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
markdown-converter capabilities & compatibility
- Capabilities
- **documents**: pdf, word (.docx), powerpoint (.p · **web/data**: html, csv, json, xml · **media**: images (exif + ocr), audio (exif + tr · **other**: zip (iterates contents), youtube urls · output preserves document structure: headings, t
npx skills add https://github.com/intellectronica/agent-skills --skill markdown-converterAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1.5k |
|---|---|
| repo stars | ★ 279 |
| Security audit | 2 / 3 scanners passed |
| Last updated | April 25, 2026 |
| Repository | intellectronica/agent-skills ↗ |
How do I handle markdown converter tasks with agent guidance?
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 tran
Who is it for?
Teams needing documented markdown converter workflows.
Skip if: Teams needing structured database ETL or binary-to-code generation rather than document-to-text conversion.
When should I use this skill?
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 tran
What you get
Structured workflow from markdown converter documentation applied to the user request.
- Markdown files
- Transcribed text
- OCR-extracted content
Files
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 markitdownSupported 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 pluginsExamples
# 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
-dwith Azure Document Intelligence
Related skills
Lark DocGenerate, update, and maintain structured documentation directly inside Lark/Feishu using natural language and agentic workflows.475kLark DriveLet their coding agents read, create, update and search documents stored in Lark (Feishu) Drive directly from prompts.475kLark SheetsConnect Claude, Cursor or other agents directly to Feishu/Lark spreadsheets for live data reads, writes, and structured automation.474kLark WikiGenerate, update, and sync structured knowledge bases inside Lark (Feishu) directly from code, specs, or agent output.474kLark WhiteboardGenerate, edit, and collaborate on visual diagrams and flowcharts directly inside Claude, Cursor or other agents.474kLark SlidesInstantly generate polished, professional slide decks from specs, roadmaps, or meeting notes using Lark/Feishu.474kForks & variants (2)
Markdown Converter has 2 known copies in the catalog totaling 270 installs. They canonicalize to this original listing.
- steipete - 259 installs
- sundial-org - 11 installs
How it compares
Pick Markdown Converter for multi-format document-to-Markdown ingestion rather than Agnes AI image generation or Spring Boot codegen skills.
FAQ
What does markdown converter do?
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 tran
When should I invoke markdown converter?
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 tran
What are key capabilities?
**Documents**: PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls)
Is Markdown Converter safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.