# markdown-img-convert

**Repository Path**: ATFWUSa/markdown-img-convert

## Basic Information

- **Project Name**: markdown-img-convert
- **Description**: 【开源-文章迁移利器】MarkDown本地图片转云端存储脚本-支持目录递归查找转换
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2023-07-08
- **Last Updated**: 2023-07-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# markdown-img-convert
## 脚本介绍
用于将markdown中本地图片，批量转存smms.app中，生成新的markdown文件。支持单文件及目录。

- 支持单个markdown文件以及递归查找某个目录下所有markdow文件进行转换。
- 完善的日志输出能力，能够查看具体上传情况。
- 支持配置smms图床的token。

详细查看介绍文章：https://blog.csdn.net/ATFWUS/article/details/131607107
## 快速使用
下载脚本：
```bash
git clone https://gitee.com/ATFWUSa/markdown-img-convert.git
```
切换路径：
```bash
cd markdown-img-convert
```
下载脚本所需依赖：
```bash
pip3 install -r requirements.txt
```
使用范例：（递归转换当成目录下所有markdow文件，指定smms.app API的token，并将日志输出到文件convert_log.txt中）（如何获取smms.app API token请自行百度）

```bash
python3 convert.py -t catalog -p . -stoken te1i**********PaBKNWiSls2EHpkxXt -log convert_log.txt
```
所有参数：
```bash
usage: convert.py [-h] -t CONVERT_TYPE -p CONVERT_PATH -stoken SMMS_TOKEN [-log LOG_PATH]

optional arguments:
  -h, --help            show this help message and exit
  -t CONVERT_TYPE, --convert-type CONVERT_TYPE
                        convert one [file] or one [catalog]
  -p CONVERT_PATH, --convert-path CONVERT_PATH
                        convert path
  -stoken SMMS_TOKEN, --smms-token SMMS_TOKEN
                        smms.app API token
  -log LOG_PATH, --log-path LOG_PATH
                        output the log into a file
```

## 使用效果
![控制台输出](https://s2.loli.net/2023/07/08/Q4jazHn8cX7i3mO.png)

![日志内容](https://s2.loli.net/2023/07/08/cMR5DJQmGC6lKFd.png)

## 设计思路
思路很简单：
- 递归查找某个目录下的所有markdown文件列表。
- 正则的方式提取出某个markdown中所有的本地图片url。
- 读取每张本地图片并上传到smms.app中，并获取转换后的url。
- 全文中替换本地图片的路径为转换后的url。
- 将替换完所有图片后的markdown内容写入新的文件。

## 自定义

- 可以简单修改配置支持更多的图片文件。
- 可以简单修改配置达到公网文件转储的功能。
- 可以添加代码做到自定义图床。
- 可以参考源代码做到更多自定义功能。