wechatmp2markdown

wechatmp2markdown 微信公众号文章转Markdown

使用

CLI 模式

通过命令行使用 执行命令：本程序可执行文件 [url] [filepath] [--image]

• url 微信公众号文章网页的url
• filepath makedown文件的保存位置，若该值为目录，则以文章标题作为文件名保存在该目录下；若以.md结尾，则以输入的文件名作为文件名保存；./为保存到当前目录
• --image 可选参数，文章内图片的保存方式，格式为--image=xxx，xxx为参数值，有三个可供选择（默认值为base64）：
  • url 图片引用原src值，它通常在网络上（不推荐，微信哪天把它ban掉就寄了）；
  • save 图片存在本地，在与markdown同一个目录中，若为web server模式，则一并打包成zip下载；
  • base64 图片编码成base64字符串放在markdown文件内

例如：windows环境，想把url为https://mp.weixin.qq.com/s/a=1&b=2的文章（假设文章标题为"2022年度总结"）转成markdown存到 D:\wechatmp_bak下，文章内的图片保存到本地

则cmd执行：

wechatmp2makrdown_win64.exe https://mp.weixin.qq.com/s/a=1&b=2 D:\wechatmp_bak --image=save

markdown和图片文件将保存在 D:\wechatmp_bak\2022年度总结\ 下

在Windows环境下，文件或路径名不能包含以下任何字符：“（双引号）、*（星号）、<（小于）、>（大于）、？（问号）、\（反斜杠）、/（正斜杠）、|（竖线）、：（冒号）。当标题包含以上字符时，本程序将用相似的Unicode字符进行替换，具体替换规则为：

"<" -> "≺"
">" -> "≻"
":" -> ":"
""" -> "“"
"/" -> "∕"
"\" -> "∖"
"|" -> "∣"
"?" -> "?"
"*" -> "⁎"

在linux环境下，使用CLI模式，需要为程序赋予可执行与写权限，例如： chmod +xw wechatmp2markdown-v1.1.6_linux_amd64

web server 模式

通过web服务使用

执行命令：本程序可执行文件 server [port]

• port 监听的端口

当看到 wechatmp2markdown server listening on :[port] 时， 打开浏览器（或curl工具）访问：localhost:[port]?url=[url]&image=[image]

• url 微信公众号文章网页的url
• image 可选参数，文章内图片的保存方式，参数值与上文CLI模式的相同

返回的数据即为该文章的markdown文件（若image=save，则返回的是zip格式的压缩包）

例如：windows环境，服务启动并监听8080端口，想把url为https://mp.weixin.qq.com/s/a=1&b=2的文章转成markdown并下载，文章内的图片保存到本地

则cmd执行： wechatmp2makrdown_win64.exe server 8080

浏览器访问：localhost:8080?url=https://mp.weixin.qq.com/s/a=1&b=2&image=save， 将返回一个zip文件

在linux环境下，使用web server模式，需要为程序赋予可执行权限，例如： chmod +x wechatmp2markdown-v1.1.6_linux_amd64

开发

go 1.20

编译

Linux or Mac 环境

# 编译目标平台: linux
make build-linux
# 编译目标平台: mac
make build-osx
# 编译目标平台: windows 64位
make build-win64
# 编译目标平台: windows 32位
make build-win32

windows 环境

需gcc，推荐安装tdm64-gcc，mingw64/bin加入系统环境变量

# 编译目标平台: linux
mingw32-make win-build-linux

# 编译目标平台: mac
mingw32-make win-build-osx

# 编译目标平台: windows 64位
mingw32-make win-build-win64

# 编译目标平台: windows 32位
mingw32-make win-build-win32

（没装gcc也无妨，去Makefile找对应的命令执行）

编译好的文件在./build目录下

TODO

• 支持解析表格元素(table tag)

最后

抓紧时间窗口。努力记录。黑暗中记得光的模样。