（4510期）文档整理技能 (document-organizer) – 旧文档一键转Markdown知识库

旧文档一键转Markdown知识库 专业文档批量转换工具，支持旧版Office（.doc/.xls等）到Markdown的高保真转换，保持格式结构完整，适合构建可搜索知识库。 使用说明 核心用法 文档整理技能是一款面向企业数字化转型的专业文档转换工具，核心能力是将历史遗留的旧版Office文档（.doc/.xls/.ppt）及现代格式（.docx/.xlsx/.pptx/.pdf）批量转换为Markdown格式。使用流程为：安装LibreOffice → 运行npx skills run document-organizer → 指定源目录与输出目录 → 自动完成批量转换。 转换链路： .doc/.docx → LibreOffice 直接转 Markdown .xls → LibreOffice 转 .xlsx → MarkItDown 转 Markdown .xlsx/.pptx/.pdf → MarkItDown 直接处理 支持按目录递归批量处理，自动保持原目录结构，错误自动记录不中断流程。 显著优点 格式保真度高：完美保留标题层级（H1-H6）、表格结构、加粗/斜体样式、列表层级 中文支持优秀：UTF-8编码确保无乱码 批量处理高效：实测1000个.doc文件约30秒完成，3000个混合类型文件10-12分钟处理完毕 旧版格式兼容：专门解决.doc/.xls等历史格式无法直接读取的问题 目录结构保持：转换后自动重建原始目录层级 可搜索知识库：输出Markdown文件天然支持全文检索，便于构建企业知识库 潜在缺点与局限性 外部依赖必需：必须安装LibreOffice（~300MB）和Python环境，无法纯浏览器运行 复杂排版损失：复杂图文混排、嵌套表格、特殊字体可能转换不完美 PPT支持有限：幻灯片转换质量标注为"良好"而非"完美" 图片型PDF不支持：扫描件/OCR需求需额外工具 Windows路径依赖：部分默认路径针对Windows优化，Linux/macOS需手动配置 无实时预览：必须完成转换后才能查看结果 适合人群 企业IT/档案管理员：需要批量数字化历史文档 知识管理工程师：构建可搜索的Markdown知识库 开发者/技术写作者：将旧文档迁移到现代文档系统（GitBook/Docusaurus等） 合规审计人员：需要提取可审计的纯文本记录 常规风险 文件覆盖风险：同名文件可能覆盖，建议先用--dry-run模拟 LibreOffice崩溃：极少数损坏文档可能导致转换进程中断，但错误隔离机制会记录并继续 编码异常：极少数非标准编码（GBK等）文档可能出现乱码 权限问题：系统级Office安装可能需要管理员权限运行 版本与维护 当前版本v1.0.4（2026-03-12），近期修复了外部脚本依赖问题，改为直接使用markitdown命令行工具，降低了部署复杂度。 原始说明 支持批量将旧版 Office 文档（.doc/.xls）高质量转换为 Markdown 并保持目录结构与格式完整。