# 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年度总结\` 下

### 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文件

## 开发
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`目录下

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