wps2md 目前主要有两个容易混淆的东西,先帮你对齐一下:
1)PyPI 上的 wps2md(Python 库 / CLI)
专门把老式 WPS Writer 的 .wps 和 Word 97-2003 的 .doc(OLE2 二进制格式)转成纯文本 / Markdown。
- 安装:
pip install wps2md(需 Python ≥ 3.10) - 命令行用法(包内 CLI 名以实际安装为准,也可走 Python API):
python
from wps2md import parse, to_markdown
doc = parse("demo.wps") # 也支持 .doc
print(doc.main_text)
# 按 Word 标题样式转成 #~######## H1-H9
md = to_markdown(doc.paragraphs)
with open("demo.md", "w", encoding="utf-8") as fp:
fp.write(md)
- 能力边界:
- ✅ 标题层级、段落、正文
- ❌ 表格、图片、页眉页脚、批注、加粗斜体等字符级样式暂不还原
- ❌ 加密文件不支持;现代
.docx别用这个,直接用python-docx或 WPS 自带导出
2)WPS 文档(.docx)转 Markdown 的常规做法
如果你其实是想把 WPS 里写的 .docx 转成 MD,不一定用 wps2md:
- WPS 新版:文件 → 另存为 / 导出 → 选 Markdown(或全选复制进 Typora / VS Code)
- WPS AI:选中内容 → "转为 Markdown",适合保留标题/列表/表格结构
- 批量 / 程序员方案:
pandoc demo.docx -o demo.md- 或上面那个
wps2md只处理老.wps/.doc,不匹配.docx
3)GitHub 上的同类项目
MaurinZBL/Wps_Parse:把.wps/.doc转 DOCX 和 Markdown,带 GUI 和批量,比 PyPI 版更"重"一点
快速判断你该用哪个:
- 文件是
.wps或老.doc→pip install wps2md - 文件是
.docx→ 用 WPS 导出 /pandoc/ WPS AI - 要保表格图片 → 先转 DOCX 再用
pandoc,别指望 wps2md 完美还原