使用vscode编写Markdown

原文

本文适用于以下对象——

  1. 从没用过Markdown的
  2. 打算开始用Markdown的
  3. 日常使用Windows平台的

Markdown的介绍大家可以参考上一篇文章;本文的目的,则是引导大家开始Markdown的写作。

1. 下载和安装vscode

1.1. 下载

随便找个搜索引擎,搜vscode,不出意外,第一个结果应该就是vscode的官方网站,长这样——

img

我相信你既然决定开始使用Markdown了,下载安装个软件应该难不倒你……吧?

需要注意的是,安装的时候,下面这两个可选项建议勾上——

img

有什么用呢?勾了这两个选项后,你就可以在windows的右键菜单里看到一个“Open with Code”的选项,使用这个选项,你可以利用windows的资源管理器来管理你的Markdown文稿目录。举个例子,我所有的公众号文章的源文件都存在“blog”文件夹下,每次我要开始写东西的话,我就在这个文件夹上右键,选择“Open with Code”,所有目录下的文件都会出现在vscode的编辑区内,便于随时切换

img

1.2. 安装中文包

嗯,默认vscode装好以后是英文的,对很多小伙伴来说可能不是太好。不过,巨硬是给做了中文包的,但需要自己装一下——

打开vscode后,左侧竖着的导航栏最底下的图标就是vscode的插件市场,在这里可以找到中文包;

img

在插件市场的搜索框里搜索“Chinese”,第一个结果就是中文语言包——

img

安装这个包就可以了,安装好后一般会提示你重启vscode;如果安装好并且重启后界面仍然是英文,则需要额外改一下vscode的配置文件(开源软件就是会比较麻烦……)。快捷键Ctrl+Shift+P调出vscode的命令行输入栏,长下面这样——

img

在输入栏里输入“language”,会模糊匹配可用的命令,选择“Configure Display Language”,vscode会为你打开一个json文件,长下面这样——

img

把其中的 "locale":"" 改成图上的 "locale":"zh-CN" ,再重启vscode,界面语言就会是中文了。

1.3. 安装Markdown增强插件

vscode默认是支持Markdown的,但是我们还是需要一些额外的插件来辅助。如前文安装中文包一般,到vscode的插件市场中,搜索Markdown关键字,安装这几个插件——

img

img

第一个插件,是一个组合包,一股脑把最常用的Markdown优化都给你装好;第二个插件,则是Github使用的Markdown渲染样式,不是特别华丽,很朴素,很简洁的样式,因为很多人用Markdown都是为了使用Github Pages,所以这个样式特别受欢迎。使用这个样式,在本地就能预览Markdown文件最终在Github Pages中显示的效果。

1.4. 开始你的第一篇Markdown文档

为了集中管理用Markdown的文档,你可以在你容易找到的地方,专门建立一个文件夹,这取决于大家使用电脑的习惯,每个人都不一样。使用vscode打开这个文件夹,你会在左侧的导航窗口里,看到这样的显示——

img

红框圈出来的,就是你的文件夹,或者说,工作目录,你觉得怎么好理解就怎么理解好了。

在这个目录下,右键可以弹出选项菜单,其中就有新建文件这样的选项。

img

选择新建文件,工作目录上就会多一行,并且可以输入文件名;请注意,文件名一定要带后缀,markdown的后缀是.md ,如下所示——

img

img

当你输入.md的后缀时,你会发现,新建的文件名前多了一个logo,这代表它已经被vscode识别为markdown文件了。现在,你就可以开始写markdown了。

img

在继续之前,请点击右上角的这个图标——

img

然后你的页面就会变成两栏分列的样子;右侧这一栏就是markdown文件被渲染为HTML的预览;由于我们安装饿了Github的渲染风格,所以这里会按照Github的样式来渲染你的markdown文件。

img

2. Markdown的部分语法

这一节全部用Gif来给大家展示——(做gif图很麻烦啊,推荐一个开源免费的软件ScreenToGif,可惜不能通过支付宝给他们捐赠……)

2.1. 标题编辑

动图封面

2.2. 正文

动图封面

2.3. 代码块

干IT的少不了和各种代码,命令行接触;Markdown的代码块功能就非常有用了——

代码块通过两行 ``` 符号框出,如果你写的代码是某种语言,那么可以在第一行末尾加上这个语言的名字,代码块内的代码就会执行对应的高亮语法,例如python

动图封面

2.4. 行内代码

正文中的代码,则通过输入`` 框出

动图封面

2.5. 列表

有序列表,输入数字,加一个句点,然后空格即可;可以缩进空置多级列表;

动图封面

无序列表,输入 - ,然后空格

动图封面

2.6. 加粗和倾斜

动图封面

上面是常用的一些用法,还有一些我没列出来的用法,比如插入表格,各位可以自行“度娘”或者“谷哥”一下。

3. 小结

相信聪明的同学已经知道我为什么建议一开始用vscode写markdown了——原因很简单,分栏输入和预览,你可以直观的看到自己输入的代码渲染后的效果,当然,这其实是大部分markdown编辑器都支持的行为——typora有些不太一样,它不是这种分栏模式。

如果你是印象笔记或者有道云笔记的用户,其实这两个笔记现在也都支持markdown了,但是说实话,使用体验我个人认为并不好,而且最重要的是,抹杀了markdown的自由性,既然都用笔记了,好像用不用markdown也无所谓了。

markdown的语法并不多,也没有很复杂的格式,样式完全基于软件所支持的CSS样式渲染,如我上一篇文章所说,很多时候,简单的就是最好的。你不太可能拿markdown来写一篇正式的论文,但是作为日常的笔记来说,markdown再好不过——够用、可迁移、专注写作。

下篇会介绍一下windows上的markdown编辑神器——typora。用熟了markdown的语法后,你可以立即抛弃vscode,投身typora的怀抱。

感谢原博主,参考地址:https://zhuanlan.zhihu.com/p/56943330

posted @ 2022-11-06 15:41  哩个啷个波  阅读(1007)  评论(0编辑  收藏  举报