v1.1.0: 文档优化与故障排除

变更内容

SKILL.md (v1.0 → v1.1)

• allowed-tools 改为列表格式，新增 Grep、Glob 权限
• 新增完整故障排除表：
  • 转换失败（5 种常见错误及解决方案）
  • 输出格式问题（表格错乱、图片丢失、中文乱码、链接失效）
  • 环境问题（conda、pip、PowerShell 兼容性）
• 优化触发条件说明，避免误触发

README.md / README_en.md

• 按 github-readme 规范重写
• flat-square 风格徽标
• 去模板化表达，中文版用中文思维
• 目录锚点导航
• 常见问题改为加粗标题 + 箭头简洁格式

.gitignore

• 添加压缩包格式忽略规则（.zip, .tar.gz 等）

V1.0.0

v1.0.0 - 初始版本发布

版本亮点

markdown-everything 正式发布！这是一个将各种格式文档转换为 Markdown 的强大工具，专为 AI Agent 设计，让 AI 能够直接读取和处理各类文档内容。

支持的文档格式

• Office 文档：PDF、Word (docx/doc)、Excel (xlsx/xls/csv)、PowerPoint (pptx/ppt)
• 多媒体：图片 OCR 识别、音频转文字
• 网页与数据：网页内容提取、JSON、XML
• 电子书：EPUB、AZW3

核心功能

• 智能格式转换：保留文档结构，输出干净的 Markdown
• 中文 PDF 优化：专门处理中文 PDF 的编码问题
• 环境管理脚本：提供 Windows (PowerShell) 和 Linux/macOS (Shell) 环境配置脚本
• 多平台支持：Windows、Linux、macOS 全平台兼容

安装方式

使用 pip

pip install markdown-everything

使用 conda

conda install -c conda-forge markdown-everything

手动安装

git clone https://github.com/yourusername/markdown-everything.git
cd markdown-everything
pip install -r requirements.txt

📖 快速开始

命令行使用

# 基本转换
markitdown input.pdf -o output.md

# 转换并指定编码
markitdown input.pdf --encoding utf-8 -o output.md

# 批量转换
markitdown input1.pdf input2.docx input3.xlsx -o output/

AI Agent 使用（推荐）

1. 将 SKILL/markdown-everything 目录添加到 AI Agent 的 skill 目录
2. 在 AI Agent 对话中使用自然语言指令即可触发转换功能

已知问题

• 部分扫描版 PDF 需要手动预处理以获得最佳效果
• 极复杂的 Excel 表格（多层合并单元格）可能需要手动调整

相关资源

• 项目文档
• English Documentation
• 问题反馈

致谢

感谢所有测试和使用这个项目的用户！

---