mac上转换word/pdf为markdown需借助工具:markitdown(推荐,保留表格/图片/ocr)或pandoc(轻量,需样式映射);还可通过automator添加右键菜单实现一键转换。

在Mac上把Word、PDF等文件转换成Markdown格式,不是靠系统自带功能一键完成的事,因为macOS没有原生支持Markdown语义解析的组件;你得借助命令行工具或专用Python程序来真正读懂标题层级、表格结构和数学公式。
用MarkItDown批量转Word/PDF/Excel
这是目前Mac上最省心的方案,微软开源,专为办公文档设计,能保留表格边框、图片路径、列表嵌套,甚至自动提取EXIF信息和OCR文字。
第一步:确保已安装Python 3.9+,终端执行python3 --version确认版本;若未安装,用Homebrew运行brew install python。
第二步:安装MarkItDown主程序,终端输入:
pip install markitdown
第三步:拖入一个Word文档到终端,直接运行转换命令:
markitdown /Users/你的用户名/文档/报告.docx -o 报告.md
这会生成同名的报告.md,含完整标题、表格、超链接——连Word里插入的Excel图表都会转成Markdown表格代码。
注意:如果文件含中文图片名或路径含空格,【必须用引号包裹完整路径】,否则命令会中断报错。
用Pandoc快速转单个Word文档
适合偶尔处理1~2个文档、不想装太多依赖的用户。它不处理图片内容,但能把样式映射做得非常准,比如Word中设为“标题1”的段落,会自动变成# 标题。
方法一:用Homebrew安装Pandoc
brew install pandoc
将 Markdown 标题大纲转换为 KMind 主题思维导图,支持主题预设、布局、连线方式、深色模式及彩虹分支,并可导出 PNG 或 SVG 图像。
方法二:终端执行转换命令
pandoc 输入.docx -o 输出.md --wrap=none
【--wrap=none参数不可省略】,否则Pandoc会自动折行长段落,破坏代码块和表格对齐。
方法三:如果Word文档用了自定义样式(如“章节标题”“注意事项”),需先在Word中将它们映射为内置样式(标题1/标题2),否则Pandoc无法识别语义,只会当普通段落输出。
右键菜单集成:点一下就转Markdown
想彻底告别终端?可以给Finder添加右键菜单选项,以后选中任意.docx/.pdf文件,鼠标右键→“转换为Markdown”,瞬间生成同名.md文件就在原目录。
第一步:查出markitdown安装路径
which markitdown
典型返回是/opt/homebrew/bin/markitdown或/usr/local/bin/markitdown。
第二步:新建文本文件,粘贴以下内容(把/opt/homebrew/bin/markitdown替换成你实际查到的路径):
#!/usr/bin/osascript
on run argv
set inputPath to item 1 of argv
do shell script "/opt/homebrew/bin/markitdown " & quoted form of inputPath & " -o " & quoted form of (inputPath & ".md")
end run
第三步:保存为ConvertToMD.scpt,双击运行一次激活权限;再打开Automator→新建“快速操作”→左侧搜索“运行AppleScript”→拖入→粘贴上面脚本→存储为“转换为Markdown”。
现在回到Finder,任意文件右键就能看到该选项了。这一步做完后,无需再打开终端或记命令。










