用途：把文档、图片、音频或 YouTube 链接转换为 Markdown，并统一处理保存路径与结果回报。
主要能力：支持 PDF、Word、PowerPoint、Excel、Outlook .msg、音频转写、YouTube 字幕等多种格式；可选用 Azure Document Intelligence 后端、第三方插件、保留内嵌 base64 图片、列出已安装插件。转换由 scripts/markitdown.sh 完成参数解析与保存逻辑。
安装：pip install 'markitdown[all]'。也可按需选择 [pdf]、[docx]、[pptx]、[xlsx]、[xls]、[outlook]、[audio-transcription]、[youtube-transcription]、[az-doc-intel] 等分组。
用法：bash "$SKILL_DIR"/scripts/markitdown.sh -s '/absolute/path/report.pdf'；参数经 shell 引号单独传递，禁止拼接 $ARGUMENTS 或使用 eval。常用示例：/markitdown ~/Downloads/report.pdf（打印到终端）、/markitdown -s ~/Downloads/report.pdf（保存）、/markitdown -s -p deck.pptx（启用插件）、/markitdown -d invoice.pdf（Azure）、/markitdown -k brand.html（保留 base64 图片）、/markitdown https://youtu.be/dQw4w9WgXcQ（YouTube 字幕）、/markitdown -l（列出插件）。
保存路径：~/.agents/output/{project}/markitdown/{slug}/。
限制：音频转写使用 recognize_google，非本地 Whisper；图片 OCR 需配置具备 OCR 能力的后端，仅安装插件并加 -p 不够；Azure 需导出 MARKITDOWN_DOCINTEL_ENDPOINT；目标文件已存在会失败；脚本退出错误码时按提示处理，不自动安装。上述行为以资料为准，其它细节暂未提供。