MarkItDown 右键工具

这是一个基于 Microsoft MarkItDown 进行二次开发的非官方 Windows 右键菜单集成工具。这里的“二次开发”是指在 MarkItDown 命令行能力之上增加 Windows Explorer 右键菜单、批量调度、转换报告以及安装、更新和卸载逻辑。

本项目不捆绑、不修改也不复制 Microsoft MarkItDown 的源码或安装包；使用前需要由用户单独安装上游项目。本项目不是 Microsoft 官方产品，也未获得 Microsoft 的官方背书。

它为文件资源管理器增加“转换为 Markdown”：支持单个文件、多选文件和文件夹第一层批量转换，自动避免覆盖，并为批量任务生成 TXT 报告。

安装

1. 获取包含以下五个文件的发布 ZIP 并解压：安装右键菜单.cmd、卸载右键菜单.cmd、更新 MarkItDown.cmd、markitdown_context.pyw、使用说明.txt。
2. 将整个文件夹放在长期保留的位置。
3. 确认当前 Windows 用户已安装 Microsoft MarkItDown，然后普通双击 安装右键菜单.cmd（不要以管理员身份运行）。如果安装器没有自动找到环境，请输入该 MarkItDown 环境中 python.exe 的完整路径。
4. Windows 11 用户可在文件右键菜单的“显示更多选项”中选择“转换为 Markdown”。

使用、更新与卸载

• 单个文件成功时，工具会在原文件旁输出同名 .md；重名时自动编号。单个失败会生成失败说明。
• 多选文件或文件夹转换后会生成成功/失败报告。文件夹只处理第一层文件；已有 Markdown 文件和已有转换报告会跳过。
• 双击 更新 MarkItDown.cmd 可更新已绑定环境中的 PyPI 正式版 MarkItDown。
• 双击 卸载右键菜单.cmd 会删除当前用户的右键功能和临时队列，不会删除 MarkItDown、Python、转换结果或报告。
• 移动或改名工具文件夹前，必须执行“先卸载 → 移动或改名文件夹 → 再安装”。

与上游项目的关系

文件解析与 Markdown 生成能力来自 Microsoft 的开源项目 MarkItDown。本工具基于并调用该上游项目，不附带也不替代它。

开源许可与声明

• 本项目自身编写的 Windows 集成代码采用本仓库中的 MIT License。
• 上游 Microsoft MarkItDown 是独立项目，并采用其仓库中公布的 MIT License；其版权及相关标识归 Microsoft 和相应贡献者所有。
• 用户安装或使用 MarkItDown 时，仍应遵守上游项目当时公布的许可证及使用条款。
• 本项目仅提供非官方的调用与集成，不暗示 Microsoft 对本项目的认可、赞助或维护。