{"id":28818419,"url":"https://github.com/raythunder/markitdown-gui","last_synced_at":"2026-05-16T17:08:07.269Z","repository":{"id":299779676,"uuid":"1004140441","full_name":"raythunder/markitdown-gui","owner":"raythunder","description":"markitdown gui exe","archived":false,"fork":false,"pushed_at":"2025-06-18T08:07:58.000Z","size":96829,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-27T12:33:15.073Z","etag":null,"topics":["epub","gui","markdown","markitdown"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/raythunder.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-18T07:15:25.000Z","updated_at":"2025-06-18T08:14:14.000Z","dependencies_parsed_at":"2025-06-18T09:33:16.344Z","dependency_job_id":null,"html_url":"https://github.com/raythunder/markitdown-gui","commit_stats":null,"previous_names":["raythunder/markitdown-gui"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/raythunder/markitdown-gui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raythunder%2Fmarkitdown-gui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raythunder%2Fmarkitdown-gui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raythunder%2Fmarkitdown-gui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raythunder%2Fmarkitdown-gui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raythunder","download_url":"https://codeload.github.com/raythunder/markitdown-gui/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raythunder%2Fmarkitdown-gui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33111500,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T04:41:52.686Z","status":"ssl_error","status_checked_at":"2026-05-16T04:41:52.009Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["epub","gui","markdown","markitdown"],"created_at":"2025-06-18T19:05:15.020Z","updated_at":"2026-05-16T17:08:07.233Z","avatar_url":"https://github.com/raythunder.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MarkItDown GUI\n\n一个基于 [Microsoft MarkItDown](https://github.com/microsoft/markitdown) 的图形界面工具，可以将各种文档格式转换为 Markdown。\n\n## ✨ 功能特性\n\n### 🔄 **多格式支持**\n- **Office 文档**: Word (.docx), Excel (.xlsx), PowerPoint (.pptx)\n- **PDF 文档**: 支持文本和图片提取\n- **电子书**: EPUB 格式，支持图片提取\n- **音频文件**: MP3, WAV, M4A 等（通过 AI 转录）\n- **图片文件**: JPG, PNG, GIF 等（通过 OCR 识别）\n- **网页文件**: HTML\n- **其他格式**: CSV, JSON, XML 等\n\n### 📚 **EPUB 图片处理**\n- ✅ **自动图片提取**: 从 EPUB 文件中提取所有图片\n- ✅ **智能路径处理**: 支持相对路径、绝对路径、Base64 编码\n- ✅ **完整保存**: 保存时自动将图片复制到输出目录\n- ✅ **格式支持**: JPG、PNG、GIF、BMP、SVG、WebP\n\n### 🎯 **用户体验**\n- 🖱️ **简洁界面**: 直观的图形用户界面\n- ⚡ **多线程处理**: 转换过程不阻塞界面\n- 📝 **实时预览**: 转换结果即时显示\n- 💾 **灵活保存**: 支持另存为功能\n- 🔧 **智能配置**: 记住用户偏好设置\n\n## 📦 安装要求\n\n### 系统要求\n- Windows 10/11\n- Python 3.8+\n\n### 依赖安装\n```bash\n# 安装 MarkItDown 及所有依赖\npip install markitdown[all]\n\n# 安装 GUI 依赖\npip install tkinter  # 通常已内置于 Python\n```\n\n## 🚀 快速开始\n\n### 直接运行\n```bash\npython markitdown_gui.py\n```\n\n### 或者构建可执行文件\n```bash\npython build_exe.py\n```\n\n## 📖 使用指南\n\n### 基本转换流程\n1. **选择文件**: 点击\"浏览...\"选择要转换的文件\n2. **配置选项**: \n   - 对于 EPUB 文件，可选择是否提取图片\n   - 选择图片引用方式（相对路径/绝对路径/Base64）\n3. **开始转换**: 点击\"转换为Markdown\"\n4. **查看结果**: 在结果区域预览转换后的内容\n5. **保存文件**: 点击\"保存结果\"选择保存位置\n\n### EPUB 图片处理\n转换 EPUB 文件时：\n- ✅ 勾选\"从EPUB提取图片\"自动提取图片文件\n- 📁 图片将保存在输出目录的 `images/` 文件夹中\n- 🔗 Markdown 中的图片引用会自动更新为正确路径\n- 💾 保存时图片会自动复制到目标目录\n\n## 🏗️ 项目结构\n\n```\nmarkitdown-gui/\n├── markitdown_gui.py     # 主程序文件\n├── build_exe.py          # 可执行文件构建脚本\n├── build.bat            # Windows 构建脚本\n├── test_gui.py          # GUI 测试脚本\n├── icon.ico             # 程序图标\n├── README.md            # 项目说明\n└── 使用说明.md          # 中文使用说明\n```\n\n## 🛠️ 开发说明\n\n### 核心技术栈\n- **GUI 框架**: Tkinter\n- **转换引擎**: Microsoft MarkItDown\n- **图片处理**: PIL/Pillow\n- **文件处理**: zipfile, os, shutil\n- **多线程**: threading\n\n### 主要功能模块\n- `MarkItDownGUI`: 主界面类\n- `extract_epub_images()`: EPUB 图片提取\n- `process_markdown_images()`: 图片引用处理\n- `copy_images_to_target()`: 图片文件复制\n\n## 🐛 故障排除\n\n### 常见问题\n1. **音频转换失败**: 需要安装 FFmpeg\n2. **某些 PDF 无法转换**: 可能是加密或特殊格式\n3. **EPUB 图片不显示**: 确保勾选了\"从EPUB提取图片\"选项\n\n### 解决方案\n```bash\n# 安装 FFmpeg (用于音频处理)\n# Windows: 下载并添加到 PATH\n# 或使用 chocolatey: choco install ffmpeg\n\n# 更新依赖\npip install --upgrade markitdown[all]\n```\n\n## 📄 许可证\n\n本项目基于 MIT 许可证开源。\n\n## 🤝 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n## 📞 联系方式\n\n- GitHub: [raythunder/markitdown-gui](https://github.com/raythunder/markitdown-gui)\n- Issues: [提交问题](https://github.com/raythunder/markitdown-gui/issues)\n\n---\n\n**感谢使用 MarkItDown GUI！** 🎉 ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraythunder%2Fmarkitdown-gui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraythunder%2Fmarkitdown-gui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraythunder%2Fmarkitdown-gui/lists"}