/tags/marker-pdf/ Recent content in marker-pdf on Hugo -- gohugo.io en Sat, 18 Apr 2026 08:00:00 +0800 /posts/markitdown-mac-install/ Sat, 18 Apr 2026 08:00:00 +0800 /posts/markitdown-mac-install/ TL;DR markitdown 是微软开源的本地文档转换工具，支持 Word (.docx/.doc)、PowerPoint (.pptx)、Excel (.xlsx/.xls)、PDF、Outlook (.msg)、音频、YouTube 视频 等多种格式转为 Markdown。 全部计算在本地完成，不依赖任何外部 API 或 OpenAPI 服务。 为什么需要这个工具 在日常工作中，我们经常遇到需要将各种文档格式转为 Markdown 的场景： 知识库文档从 Word 迁移到 Markdown 格式 PPT 演示文稿内容提取 PDF 报告转为可搜索的文本 Excel 数据表格转为 Markdown 表格 在我的使用里，markitdown 目前比较好地覆盖了“格式转换”和“离线可用”这两个需求。 前置条件 markitdown 要求 Python 3.10+。macOS 自带的 Python 通常版本较低，需要通过 Homebrew 安装新版本。 1. 确认 Homebrew 可用 brew --version # Homebrew 5.x 2. 安装 Python 3.12 brew install python@3.12 安装路径：/opt/homebrew/bin/python3.12（Apple Silicon Mac）。 3. 创建虚拟环境 在项目目录下创建虚拟环境（我一般放在项目内，避免全局污染）： /opt/homebrew/bin/python3.12 -m venv .