docx2md-picgo：Word 文档图片一键上传图床工具

docx2md-picgo：Word 文档图片一键上传图床工具

简介

upload_to_picgo.py 是一个专为博客写作者设计的自动化脚本。

很多人习惯用 Word（.docx）写笔记，再转成 Markdown 发布博客。但转换后图片路径全是 media/image1.png 这类本地引用，上传到博客后图片全部无法显示。手动一张张上传图床再替换链接，91 张图就要操作 91 次，极其繁琐。

这个脚本配合 PicGo + GitHub 图床，实现全程自动化：

Word 文档  →  提取图片  →  PicGo 上传  →  CDN 链接  →  新 MD 文件

一条命令，所有图片自动上传并替换链接，直接得到可发布的 Markdown 文件。

功能特性

• 自动解压 docx，无需手动操作，直接从 Word 文件提取图片
• ️ 智能重命名，图片自动加上文章名前缀（如 pikachu_image1.png），多篇文章不会相互覆盖
• 调用 PicGo 本地 API，无需填写 Token，利用已有图床配置直接上传
• 自动替换为 CDN 链接，支持 jsDelivr 加速
• 生成新 MD 文件，原文件保留不动，输出带图床链接的新文件
• ️ 失败提示，上传失败的图片会单独列出，不影响其他图片

适用场景

前置要求

软件：

• Python 3.10+
• PicGo（需要启动并开启 Server）

PicGo 配置：

• GitHub 图床已配置（仓库、分支、Token、存储路径）
• PicGo-Server 已开启，端口默认 36677

Python 依赖：

pip install requests

️ 配置说明

打开脚本，修改顶部配置区的变量：

# ========== 配置区（按需修改） ==========
PICGO_API = "http://127.0.0.1:36677/upload"   # PicGo Server 地址，一般不用改
CDN_BASE  = "https://cdn.jsdelivr.net/gh/你的用户名/你的仓库@main/img"  # 改成你自己的
​
DOCX_PATH = "pikachu.docx"           # Word 文件名
MD_PATH   = "pikachu靶场笔记.md"      # 转换好的 MD 文件名
OUTPUT_MD = "pikachu靶场笔记_图床版.md"  # 输出文件名

CDN_BASE 格式：

https://cdn.jsdelivr.net/gh/GitHub用户名/仓库名@分支名/存储路径

例如：

​

使用教程

Step 1：准备文件

将以下文件放到同一个文件夹：

 你的文章文件夹/
├── upload_to_picgo.py    ← 本脚本
├── pikachu.docx          ← 原始 Word 文件
└── pikachu靶场笔记.md    ← 已转换好的 MD 文件

Step 2：修改配置

打开 upload_to_picgo.py，修改配置区的文件名和 CDN 地址。

Step 3：启动 PicGo

确保 PicGo 正在运行，Server 开关已打开。

Step 4：运行脚本

cd 你的文章文件夹
python upload_to_picgo.py

Step 5：查看输出

=======================================================
   Pikachu 靶场笔记 - 图片批量上传工具
=======================================================
 正在解压 pikachu.docx 提取图片...
 共提取 91 张图片
​
 开始上传图片到 PicGo...
​
  [01/91] 上传 pikachu_image1.png ...  ...
  [02/91] 上传 pikachu_image2.png ...  ...
  ...
​
=======================================================
 上传完成：成功 91 张，失败 0 张
 已替换 91 处图片链接
 新 MD 文件已保存至：pikachu靶场笔记_图床版.md
​
 全部完成！

得到 pikachu靶场笔记_图床版.md，图片全部替换为 CDN 链接，直接发博客

复用到其他文章

每次写新文章，只需修改配置区三行：

DOCX_PATH = "sqlmap.docx"
MD_PATH   = "sqlmap笔记.md"
OUTPUT_MD = "sqlmap笔记_图床版.md"

图片会自动命名为 sqlmap_image1.png、sqlmap_image2.png，与其他文章完全隔离，不会覆盖。

常见问题

Q：提示「无法连接 PicGo Server」

确认 PicGo 正在运行，且 PicGo-Server 开关已打开，端口为 36677。

Q：提示「找不到 docx 文件」

确认脚本和 docx 在同一目录，或在配置区填写完整路径，例如：

DOCX_PATH = r"D:Backup桌面pikachupikachu.docx"

Q：图片上传成功但 MD 里链接没变

检查 MD 文件中图片引用格式是否为 media/imageX.png，其他格式暂不支持。

Q：部分图片上传失败怎么办

脚本会在最后列出所有失败的图片名，手动用 PicGo 上传这几张后，在 MD 里手动替换即可。

获取脚本

# 直接下载
  # 或你存放的仓库地址

License

MIT License，自由使用和修改。