pi-agent-pi-markitdown

Convert any document to Markdown using Microsoft's markitdown CLI — as a Pi extension.

Install

pip install 'markitdown[all]'     # Required: the conversion engine
pi install npm:pi-agent-pi-markitdown

Then reload Pi (/reload).

Usage

As a tool (LLM auto-calls)

Just ask: "convert this pdf to markdown", "transcribe this mp3", or "get the YouTube transcript".

As a command

/markitdown ~/report.pdf           # Convert, output inline
/markitdown -s ~/report.pdf        # Convert + save to ~/.pi/output/
/markitdown -s -p deck.pptx        # Use third-party plugins
/markitdown -d invoice.pdf         # Azure Document Intelligence
/markitdown -k brand.html          # Keep base64 images
/markitdown https://youtu.be/xxx   # YouTube transcript
/markitdown -l                     # List installed plugins

Tool parameters (for the LLM)

| Parameter | Type | Description | |-----------|------|-------------| | path | string (required) | File path or URL | | save | boolean | Save to ~/.pi/output/ | | useDocIntel | boolean | Azure Document Intelligence | | usePlugins | boolean | Enable 3rd-party plugins | | keepDataUris | boolean | Keep base64 images inline |

Supported formats

PDF, DOCX, PPTX, XLSX, HTML, CSV, JSON, XML, EPUB, ZIP, images (OCR/EXIF), audio (transcription), YouTube URLs.

Requirements

• Python 3 + markitdown (pip install 'markitdown[all]')
• Pi coding agent

Source

本扩展基于 coroboros/agent-skills 中的 markitdown skill 移植为 Pi 扩展。

• 原始安装命令：npx skills add coroboros/agent-skills --skill markitdown
• 原始作者：coroboros

License

MIT