Featured image of post 写作那点事(一):Typora 进行 markdown 写作并绑定阿里云 Oss 直传图片

写作那点事(一):Typora 进行 markdown 写作并绑定阿里云 Oss 直传图片

程序员的写作离不开 markdown,在调研了一众写作工具后,选择了一次性付费的 Typora 作为 markdown 写作工具,兼顾了阿里云 Oss 直传图片与 github 部署等功能。

调研

前期作了一些漫无目的的调研,自己的写作需求大致分为三类,一部分是为了记笔记,另一部分是考虑了基于 markdown 的静态博客站点生成,最后才是纯粹的文字写作需求。markdown 无疑都能满足。另外,通过一些工具,也能将 markdown 格式的内容转化为微信公众号、知乎回答等其他格式,所以综合考虑下来,markdown 仍然是较为合适的选择。

调研过程中也考虑了印象笔记等付费产品,云端跨端同步也确实非常方便,但年卡用户的种种限制也令人望而却步,比如标准帐户月上传流量的限制、单条笔记大小的限制等等。而隐私保护锁等需求,更是要升级超级会员才能有。

所以免费、开源、好用的编辑器,同时能解决图片上传需求,又能搭配 git 仓库实现跨场景同步的写作工具集(Typora + 阿里云OSS + Gitea + Cpolar),对我来说最为合适。

Typora

几种编辑器考察下来,最终还是选择了 Typora 。简洁大气,又不占用内存,设计理念较为先进,也能通过插件满足各种“奇奇怪怪”的需求。

适时预览

Typora 的编写界面不是分屏预览,有人觉得分屏预览更方便,但我是觉得没必要,程序员半屏资源查查资料找找文献很好用。另一方面,适时预览可以充当一个好用的 markdown 文件的阅读器,其简洁美观界面,实际上提供了良好的阅读体验。

img

扩展

Typora还支持数学公式、表格、图像等丰富的Markdown语法和扩展功能。

img

图片

在涉及到插入图片时,支持网络图片插入时上传,也支持直接插入本地图片上传。Typora 提供了 iPic / uPic / Picsee / PicGo-Core / PicGo.app 等图片管理插件工具。有些需要付费,有些是开源工具。通过配置,可以方便的直接做到“插入即上传”。

官方图片工具集文档:

https://support.typora.io/Upload-Image/

Typora 配置阿里云 Oss 图片上传

Typora 的图片管理工具丰富,可以将本地或网络图片上传至 Github 、Flickr 等图像托管服务。这里主要介绍配置基于 node.js 的 Pic-Go-Core 工具来将图片上传至阿里云Oss。

对于国内用户来说阿里云Oss服务低至9元/年,完全够用。以下设置假设用户已开通阿里云 Oss 服务并已设置 accessKey 权限,允许通过令牌上传文件。

安装 PicGo-Core

假设您本地已有 npm 或 yarn 等 node.js 包管理工具:

npm install picgo -g

或者

yarn global add picgo

验证安装:

which picgo

配置 picgo 的 config.json 文件

在目录:/usr/local/bin/picgo~/.picgo/config.json 目录下,找到 config.json 文件,如果你是 Windows 系统,该文件应当存在于目录 C:\Users\[your user name]\.picgo\config.json 下。

使用 nano 命令打开 config.json 文件并配置:

{
  "picBed": {
    "uploader": "aliyun",
    "aliyun": {
      "accessKeyId": "this is your accessKeyId",
      "accessKeySecret": "this is your accessKeySecret",
      "bucket": "your-oss-bucket",//换成你自己的Bucket名称
      "area": "oss-cn-shanghai",//OSS概览里的EndPoint(地域节点),“.”前面的内容
      "path": "yourImgDir/",//Bucket下的文件夹,没有可以不写,默认不要文件夹
      "customUrl": "https://your-ossname.oss-cn-shanghai.aliyuncs.com",//OSS概览里的Bucket域名(开头要https://)
      "options": ""//可以不写
    }
  },
  "picgoPlugins": {}
}

保存配置并退出。

设置 Typora

Typora-设置-图像-上传服务设定:选择自定义命令。

在随后的命令一栏输入 picgo 的所在目录与 upload 命令。

using-typora-to-write-and-bind-to-Alibaba-Cloud-OSS2

设置完毕后,无论网络图片,还是本地图片文件,直接在写作中粘贴,即可自动上传。

这在编写 markdown 生成的博客内容时非常有用,非常高效。