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