MarkdownPicPicker-3 秒钟将图片添加到 Markdown 中

1,371 阅读4分钟

MarkdownPicPicker

项目介绍

MarkdownPicPicker 是一个Markdown写作辅助工具。它能将剪贴板中的图片上传到网络图床中,并将markdown格式的图片链接(![](<图片地址>))复制到剪贴板中。

功能介绍

第1.1.0版有以下功能:

  1. 图床支持七牛云与SM.MS, 默认使用SM.MS
  2. 开箱即用,不需要配置
  3. 通过配置实现自定义图床
  4. 支持Mac OS
  5. 将图片保存在本地
  6. 图片上传成功后将Markdown格式的图片地址保存到剪贴板中
  7. Uploader扩展性

使用方法

Windows

  1. 下载最新版程序:github.com/kingname/Ma…
  2. 复制图片到剪贴板
  3. 双击运行markdownpicpicker.exe

Mac OS

  1. 安装pngpaste: brew install pngpaste
  2. Clone 源代码
  3. 复制图片到剪贴板
  4. python MarkdownPicPicker.py

配置

使用七牛云

在没有配置文件的情况下,MarkdownPicPicker默认使用的图床为SM.MS, 但是这个图床仅仅作为临时使用,可能会被墙,也不保证数据安全。如果你需要使用七牛云,请创建config文件夹,并将config.ini配置好再放进去。

配置

配置文件保存在config/config.ini文件中,其意义分别如下:

[basic]
picture_folder = pic #必需,用来在本地保存图片的副本,名字任意
picture_suffix = png #必需,图片后缀名,请使用png
# 图片上传插件的文件名,不带".py"
picture_host = QiniuUploader

[QiniuUploader]
access_key = Q6sS422O0fasfsadasdfahqasdftqvyQasdf5Zvzw
secret_key = 6QtAqqTxoSxZadffsdfasdfaaffasCmoOaB2aLObM
container_name = picturebed
url = http://7sbpmp.com1.z0.glb.clouddn.com/{}

注意:在实际使用中,请将上面的注释部分去掉,避免出现不必要的问题。

其中access_keysecret_key 可以在七牛云的控制面板中看到,如图:

container_name 为下图所示内容:

只复制图片链接

如果你希望只将图片的url复制到剪贴板中,而不是复制![](图片url), 你可以为markdownpicpicker.exe添加上 -linkonly 参数。在markdownpicpicker.exe所在目录打开cmd, 输入:

markdownpicpicker.exe -linkonly

建议大家使用AutoHotKey来启动程序。这样可以把整个流程缩短到2秒钟。AutoHotKey的配置示例如下图所示:

需要首先使用QQ截图或者其他截图工具将图片保存到剪贴板中,然后按下设定好的快捷键即可。Markdown格式的图片链接就已经保存到剪贴板中了。在需要使用的地方直接粘贴。

开发

目前MarkdownPicPicker支持七牛云SM.MS两个图床,但是你可以非常方便的将自己的图床集成到MarkdownPicPicker。希望你能在集成了自己常用的图床以后,给我发一个PR,从而造福大家。

规则说明:

  • 请将你的图床上传程序放在uploader文件夹下,文件名任意,例如ExampleUploader.py
  • 程序的类名必需为Uploader
  • 如果你的图床需要token等等一系列参数,请在init中设置config_info参数,你写在配置文件中的所有参数都将会通过config_info以字典的形式传进来。
def __init__(self, config_info=None)
  • 程序必须有一个upload方法:
def upload(self, picture_path, link_only=False)
  • 打开config/config.ini, 添加你的上传程序的相关信息,Section为你的上传程序的名字(不含.py)并设定[basic]下的picture_host为此Section例如:
[basic]
picture_folder = pic
picture_suffix = png
picture_host = ExampleUploader

[ExampleUploader]
token = 123456
url = http://xxx.xxx/upload

说明

如果你希望自己从源代码编译程序,请注意以下问题:

Pillow bug修正

本程序Windows端使用了Pillow库中的 ImageGrab.grabclipboard() 方法来获取剪贴板中的数据,但是由于这个方法有一个bug, 导致可能会发生以下错误:

Unsupported BMP bitfields layout

这个问题从Pillow 2.8.0开始,一直到3.2.0都没有被官方解决。目前有一个间接的解决办法。 请打开Python安装目录下的\Lib\site-packages\PIL\BmpImagePlugin.py文件,将以下代码:

if file_info['bits'] in SUPPORTED:
    if file_info['bits'] == 32 and file_info['rgba_mask'] in SUPPORTED[file_info['bits']]:
        raw_mode = MASK_MODES[(file_info['bits'], file_info['rgba_mask'])]
        self.mode = "RGBA" if raw_mode in ("BGRA",) else self.mode
    elif file_info['bits'] in (24, 16) and file_info['rgb_mask'] in SUPPORTED[file_info['bits']]:
        raw_mode = MASK_MODES[(file_info['bits'], file_info['rgb_mask'])]
    else:
        raise IOError("Unsupported BMP bitfields layout")
else:
    raise IOError("Unsupported BMP bitfields layout")

修改为:

if file_info['bits'] in SUPPORTED:
    if file_info['bits'] == 32 and file_info['rgba_mask'] in SUPPORTED[file_info['bits']]:
        raw_mode = MASK_MODES[(file_info['bits'], file_info['rgba_mask'])]
        self.mode = "RGBA" if raw_mode in ("BGRA",) else self.mode
    elif file_info['bits'] in (24, 16) and file_info['rgb_mask'] in SUPPORTED[file_info['bits']]:
        raw_mode = MASK_MODES[(file_info['bits'], file_info['rgb_mask'])]
    '''新增内容开始'''
    elif file_info['bits'] == 32 and file_info['rgb_mask'] == (0xff0000, 0xff00, 0xff):
        pass
    '''新增内容结束'''
    else:
        raise IOError("Unsupported BMP bitfields layout")
else:
    raise IOError("Unsupported BMP bitfields layout")

就能解决本问题。

TODO

  • 支持更多的截图方式
  • 不借助pngpaste实现获取剪贴板中的截图
  • 支持更多的图床
  • 窗口隐藏
  • 适配Linux

感谢

赖信涛