VSCode让markdown编写前所未有的顺滑

VSCode让markdown编写前所未有的顺滑

涉及到的工具及服务

  • VSCode
  • Markdown Preview Enhanced
  • Markdown PDF
  • markdownlint
  • PicGo
  • 阿里云OSS(对象存储)

markdown的概念不再赘述,其好处这里再啰嗦一遍:

  • 纯文本,所以兼容性极强,可以用所有文本编辑器打开。
  • 让你专注于文字而不是排版。
  • 格式转换方便,Markdown 的文本你可以轻松转换html、电子书等。
  • Markdown 的标记语法有极好的可读性。

安装VSCode

VScode是一款非常轻量级的编辑器,可以通过安装甚至自己编写一些小的插件来满足各种不同的使用需求,除了编写代码,使用它写markdown文件,也是十分方便,甚至超越了专门的markdown编辑软件(比如typora,之前用它整理书稿的时候经常卡死)

vscode获取方法如下:

vscode 官方网站(无需翻墙):https://code.visualstudio.com
vscode 下载链接:https://code.visualstudio.com/Download

安装markdown相关插件

vscode-扩展搜索markdown相关插件,如下图所示:

20200208131629.png

常用的插件如下,大家可根据需要下载:


20200208132110.png

令人头疼的图片问题

前三个插件都很简单,安装后即可使用,下面重点介绍下PicGo,它很好地解决了markdown长期以来困扰我的一个问题——图片问题

问题产生

因为markdown是种文本编辑规范,对图片的支持天然不足。根据markdown规范,图片通过下面格式处理,图片的url支持本地文件目录及网络地址。

Format: ![Alt Text](url)

但实际使用时,我们会发现与常用的word等工具相比,这种操作简直太不友好了:

  • 纯文本格式,不支持直接粘贴图片,即无法通过截屏后直接粘贴图片(个人感觉不方便的地方)

常见的处理方式有两种:

  • 方式一:使用本地文件目录图片,缺点:文档分享时很麻烦,需要把图片目录一并发给他人。
  • 方式二:使用网络图片,缺点:需要先把图片传到图床平台(即能够存储文章图片的地方并且可获取图片地址,如github),然后把图片地址贴回文档,人工进行此操作过于繁琐。

解决方法

vsCode常见的处理办法是基于方式二,PicGo插件极大地简化了上传图床并粘贴图片地址的操作,其便捷程度几乎达到了复制粘贴的效果,完美地满足了vsCode中markdown文件的贴图需要。

安装插件

vsCode-扩展中搜索并安装picgo插件,如下图所示:

20200208154402.png

官网地址 https://github.com/PicGo/vs-picgo

配置插件

该工具开箱即用,真正实现零配置,默认采用sm.sm图片服务。

20200208154637.png

不仅如此,还支持主流的对象存储服务,如阿里云的OSS、腾讯的COS、github、七牛云等。本文中,我们以阿里云OSS图片为例,做下介绍。


20200208155554.png

其中,Access Key IDAccess Key SecretAreaBucket为必填项。具体的获取页面,每家云服务厂商会有所不同,补充说明如下:

  1. Access Key IDAccess Key Secret阿里云的可通过下面路径获取,参考下图。

    20200208160138.png

  2. Area就是地域的英文代码如oss-cn-beijing,可通过访问域名快速找到。

    20200208161119.png

  3. Bucket就是用存放picgo上传图片的bucket

使用插件

先通过截图或其他方式将图片加载至剪贴板中,将光标停在需要插入图片的地方,使用快捷键即可插入图片,如mac中的Cmd+Opt+U

20200208162055.png

PicGo已经帮我们把图片传到阿里云的OSS中,并且自动将markdown图片地址帮我们写好了,so easy!

补充说明

设置图片大小

markdown文件是没法调整图片大小的,阿里云OSS的图片地址处理参数恰好可以解决此问题。如下面地址中的?x-oss-process=image/resize,p_40可实现缩小40。

https://lys-picgo.oss-cn-beijing.aliyuncs.com/20200208132110.png?x-oss-process=image/resize,p_40

更多的操作指令参考 https://help.aliyun.com/document_detail/44686.html

印象笔记

印象笔记已经很好的支持了markdown格式了,而且支持ctr+V将图片直接插入,如下图所示。

20200208163152.png

但印象笔记将图片地址封装成一个只有它自己能识别的字符串,不具备流通性。其他工具无法正常显示图片,这也是比较遗憾的地方。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 219,869评论 6 508
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,716评论 3 396
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 166,223评论 0 357
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,047评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,089评论 6 395
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,839评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,516评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,410评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,920评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,052评论 3 340
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,179评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,868评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,522评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,070评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,186评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,487评论 3 375
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,162评论 2 356

推荐阅读更多精彩内容