《markdown》语雀导出markdown的图片外链问题

Posted 帅气的黑桃J

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了《markdown》语雀导出markdown的图片外链问题相关的知识,希望对你有一定的参考价值。

本文节选自本人博客:https://www.blog.zeeland.cn/archives/rgoioiabeoi32

Introduction

本人因为经常使用语雀写博客,但是因为语雀转markdown的时候图片存在防外链行为,如果想要把转出的markdown发表在其他平台,就需要把md中所有的图片地址改成没有放外链的地址,这样子才可以让别人正常查看。

刚开始的时候,对于语雀导出的markdown,里面的图片我都是结合PicGo一张一张的将图片的链接转移成自己的图床,但是因为本人一直都有发博客的需求,这个问题我是不太忍得了,加上网上搜索也没有什么人做了相似的解决方案,因此笔者自己用python写了一个转换器,旨在解决这个问题,笔者设计了一个可以批量转换markdown中的图片链接为自己的图床的链接的转换器,并重写成一个新的md文件。您只需要修改yaml配置就可以直接运行,十分方便。

项目地址:https://github.com/Undertone0809/md-img-converter

功能

  • 批量下载markdown中所有的图片
  • 上传markdown的图片到你的图床
  • 替换markdown中的图片链接
  • 生成一个新的markdown文件,里面的图片链接都来自你的图床本地路径文件

注意事项

  1. 如果你想要支持其他的图床,只自己实现一个adapter适配器即可
  2. markdown中的图片链接必须是url形式的,可以从web上下载

快速上手

注意:如果你想用阿里云的图床,你的python版本必须是3.6。因为oss2最多只支持python 3.6,这个点很烦,aliyun有点懒,不维护新版本。

  1. pip
pip install -r requirements.txt
  1. config yaml
  • 你需要填写config.yaml中的一些配置信息,下面提供了两种config.yaml模板,可以根据自己的需求二选一copy

  • 你可以使用test.md来测试转换后的效果

  • 如果你想要将图片link转换成阿里云图床的link

# 需要转换的markdown文件
file_path: "test.md"
# 适配器选择,如果你想转换成你的阿里云图床
adapter: "Aliyun"
# 是否保存图片到本地
save_image: True
# Aliyun oss config
Aliyun:
  access_key_id: "your key"
  access_key_secret: "your key secret"
  bucket_name: "your bucket"
  place: "beijing"
  • 如果你想要保存到本地
# 需要转换的markdown文件
file_path: "test.md"
# 适配器选择,如果你想转换成你的阿里云图床
adapter: "Local"
  1. 运行程序
  • 您唯一需要做的就是运行下面的命令。
python main.py
  1. 生成转换后的文件
  • 运行程序后,转换md图片链接后的文件名为 yourfilename_converted.md.

如果你选择保存在本地,那么图片将保存在images中,在markdown中以相对路径的方式存在,因此你在移动markdown文件的时候要把对应的images文件一起copy走。 没有人想把它作为绝对路径,因此我并没有设置本地绝对路径的功能实现,如果你有这样的需求,欢迎pr。

最终效果

语雀转换成markdown之后的文件如下图所示

运行主程序之后:

以后在语雀导出markdown之后,如果想要再将markdown发表到其他平台上,只需要简单的转换一下就可以了,不需要再一张一张图片的换了。

附上笔者关于该问题的另外一篇讨论,和另外一种解决方案: https://www.blog.zeeland.cn/archives/markdown-patch-solution

以上是关于《markdown》语雀导出markdown的图片外链问题的主要内容,如果未能解决你的问题,请参考以下文章

工具修复语雀转md时图片无法正常外链显示的小工具

语雀文档编辑器将开源:始于但不止于Markdown

语雀文档编辑器将开源:始于但不止于Markdown

有道云笔记 迁移 语雀过程记录

有道云笔记 迁移 语雀过程记录

有道云笔记 迁移 语雀过程记录