markdown converter
- Repo stars 4,110
- Author repo agent-scripts
- Domain
- Data
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @steipete · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 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
Sections and files
Listed in source order.
sections -> Basic Usage → Supported Formats → Options → Examples → Notes
terms -> Documents · Web/Data · Media · Other
files/cmd -> uvx markitdown · input.pdf · output.md · input.docx · Web/Data · report.docx · report.md · data.md
body sha256 -> c4163eeecbd9
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
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