用途：把输入文档转换为 Claude 更易读的 Markdown，减少 PDF 的 token 开销和格式噪声，改善多栏、表格较多 PDF 的理解效果。
主要能力：接受 $1 输入路径，支持 .pdf、.docx、.pptx、.xlsx、.html、.epub、.csv、.xml；$2 为可选输出路径，省略时在输入文件旁生成同名 .md。先用 MarkItDown 一次转换所有格式；非 PDF 直接进入校验；PDF 则做三角检查，若出现多页却输出极短、表格塌成单行、不同栏文字交错、公式变乱码等信号，则回退用 OpenDataLoader-PDF 重跑。
使用方式：先验证输入存在，再用以下命令转换： markitdown "$1" > "$OUT" 必要时改用： opendataloader "$1" -o "$OUT" --format markdown 最后读取输出前 30 行校验标题层级、表格、元数据与正文连贯性，并报告输出路径、字数及所用工具。一次性安装： pip install markitdown OpenDataLoader-PDF 安装见其 GitHub 项目页。
适用场景：用户把文档放入目录后让 Claude 读取，先统一转换再长期使用干净版本。
限制：源文件已是 .md、.qmd、.tex 时不必转换；需要边界框来源引用时应直接使用 OpenDataLoader-PDF 完整功能；纯扫描件无文本层时两种工具均无效，需先用 OCR。