1 背景
Markdown 是一种轻量级标记语言，使人可以将时间都花在撰写内容而不是调整格式上，用来写技术文档再合适不过了。但markdown有个痛点---添加图片不方便。
markdown添加图片的方法：
- 方法1：插入本地图片（支持绝对路径和相对路径）
- 方法2：插入网络图片
如果图片在本地，markdown中插入本地图片，这样做缺点很多：1 本地图片路径更改或丢失导致markdown找不到图片； 2 分享不灵活，mk文档发给别人时，找不到图片路径。
插入网络图片，需要自己制造图床，写文档时并不方便，另外看文档时需要网络环境。
还有一种办法，用base64转码工具，把图片转成一段字符串，然后引用这段base64编码即可，这样添加图片比较方便，但是需要一些多的动作。
- 方法3：图片转为base64
![avatar][doge]
# 放在文章末尾
[doge]:data:image/png;base64,iVBORw0......
2 图片转为base64
2.1 剪切板图片转为base64
在添加图片时，大多数情况可以使用截图工具（常用snipaste），将截图复制到剪切板，然后运行python脚本，将剪切板的截图转为base64格式字符串，然后将此字符串贴回到剪切板，供我们粘贴使用。
img2base64.py内容如下：
（python3脚本，脚本来源于网络）
import base64
from PIL import Image
from PIL import ImageGrab
import pyperclip
from io import BytesIO
im = ImageGrab.grabclipboard()
def pil_base64(image):
img_buffer = BytesIO()
w, h = image.size
# image.thumbnail((480, 480))
image.save(img_buffer, format='JPEG', quality=95)
byte_data = img_buffer.getvalue()
base64_str = base64.b64encode(byte_data)
return base64_str
if isinstance(im, Image.Image):
print(im.format, im.size, im.mode)
px = im.load()
msg = str(pil_base64(im))
msg = 'data:image/png;base64,' + msg[2:-2]
#print(msg)
pyperclip.copy(msg)
else:
pass
为了方便使用，可以将这个脚本制作成exe可执行程序。
# 生成可执行文件
pip install pyinstaller
pyinstaller -F -w img2base64.py #打包成exe, 在且不包含控制台，exe默认在dist目录下
2.2 将markdown本地图片转为base64格式
写markdown文档时，如果像2.1节一样，一张图一张图转base64，但效率比较低，我们也可以写文档时先临时插入本地图片，写完之后通过脚本一次性生成base64的形式。
脚本有如下要求：
- 1 读取markdown文件，并用正则查找出所有的本地引用标签
- 2 替换图片标签
为![image-name][image-name] - 3 在md文件后面追加上base64编码
[image-name]:图片base64编码
mark2base64.py脚本如下：
参考：
- markdown中图片转base64
- [一款图片文件转 Base64 编码的 Python GUI 工具](