近几年Markdown这种轻量级的文本编辑非常火,虽然不能代替我们现在依旧在使用的word,但是许多创作平台已经把Markdown的文件格式纳入平台,这意味着以后写博客写公众号什么的就可以直接在Markdown上完成写作,然后再在第三方平台转到创作平台上,比如简书,CSDN,公众号、知乎,这些都可以使用Markdown的语法。
知道Markdown这么强大以后,我就开始着手在Markdown上写了一些东西,使用起来也很舒服。下面就分享如何在VSCode上使用Markdown。
我之前一段时间一直使用的Markdown软件是typora,前不久官网刚通知收费,这是多么的遗憾啊,那作为白嫖党,我就去搜了一下其他的Markdown写作软件,试了好多,比如 Macdown、Marxico、Atom、MWeb,等等等等,最后对比了一下,还是选择了VSCode,不为别的,就是喜欢,现在许多软件在VSCode上提供了插件,VSCode也成为我电脑上必不可少的写作软件。
在VSCode上写Markdown 文件,真的太简单了,只需要一个插件【Markdown All in one】 ,安装完毕直接可以使用。
前提是你要装好VSCode,并且适配好中文语言环境。
VSCode中文语言环境配置教程
接下来就说一下在书写Markdown时常用的一些语法,语法也是非常简单,一些就会,网上有很多超级长的教程,根本不需要,看一篇文章就能学会。我来列举一下我在写Markdown时经常使用的语法。
文本的写法
普通段落文本
普通段落和用word书写无异,直接书写即可。如:
奥林匹克运动会,是国际奥林匹克委员会主办,每四年一届。
在文章中一个段落中可以有多个句子,句子用句号,问号,惊叹号等结束,而一个段落的结束用回车。
斜体、粗体、删除线
在文章中突出要点词语,句子可以用倾斜,加粗等方式展现,word中要选中文本,然后赋予样式,而markdown只要在文本的前后加上*
号就可以了。
前后各加一个*
号,文字将倾斜:
*斜体*
的最终效果是斜体
前后各加两个*
号,文字将加粗:
**粗体**
的最终效果是粗体
前后各加两个~
号,文字中将出现删除线,这是一种反向强调,表示“不应该”,“不正确”等等意思:
~~删除~~
的最终效果是删除
下表列出所有特殊符号对应的效果
语法 | 效果 |
---|---|
*斜体1* |
斜体1 |
_斜体2_ |
斜体2 |
**粗体1** |
粗体1 |
__粗体2__ |
粗体2 |
~~删除线~~ |
删除线 |
***斜粗体1*** |
斜粗体1 |
___斜粗体2___ |
斜粗体2 |
***~~斜粗体删除线1~~*** |
斜粗体删除线1 |
~~***斜粗体删除线2***~~ |
斜粗体删除线2 |
“
斜体、粗体、删除线可混合使用。上述的
*
,_
,~
这些符号都是英文符号,在中文环境下使用较少,所以用来标明特殊格式不会有问题,如果要使用上述符号,请在前面一个,比如
*
最终效果是*
。
用这种前后加符号的方式来标注特殊格式好处是更加快捷,修改方便,而且是可读文本,在markdown编辑器中这些符号会转换为格式,而普通的文本编辑器看到的是符号,不会影响阅读内容。
红字文本
红字文本是比倾斜,加粗更加醒目的突出样式,word中通常是选中文本,然后点击字体颜色。markdown中则是在要标红的文本前后各加一个```符号,方法和前面介绍的倾斜,加粗一样:
红字
的最终效果是红字
“
红字也可以和斜体,粗体,删除线混合使用。如
*
倾斜红字*
的最终效果是倾斜红字。markdown设置不同的字体颜色只有```一个符号,默认就是红色,但是可以用css
设置为其它颜色,如蓝色,绿色,但只有一种异色效果。
标题
markdown中在一个普通段落前加#
,将其设置为标题。一个#
就是一级标题,两个#
就是二级标题,一共可以有六级标题。
语法 | 效果 |
---|---|
# 一级标题 |
一级标题 |
## 二级标题 |
二级标题 |
### 三级标题 |
三级标题 |
#### 四级标题 |
四级标题 |
##### 五级标题 |
五级标题 |
###### 六级标题 |
六级标题 |
作为最常见的一级标题和二级标题,还可以用另一种写法,一级标题下面加上三个(或更多)连续的=
号,二级标题下面加上三个(或更多)连续的-
号:
语法 | 效果 |
---|---|
一级标题 === |
一级标题 |
二级标题 --- |
二级标题 |
“
注意和前面介绍的文本格式不同,标题不需要在首尾各加一个特殊符号,只要在首部加
#
就可以了,而且必须是在行首。标题和普通文本一样,里面的文本也可以用红字,斜体,粗体,删除线。但是一般标题的样式都是粗体,再用粗体肉眼分辨不出来。
图片的写法
可用下面的格式在文章中插入图片:
![图片名](图片文件路径)
其中图片名可以省略。图片文件路径可以是绝对路径,如C:WindowsGreenstone.bmp。如果图片和文章在同一个目录下,也可以只有文件名。例如:![径](田径.jpg)
“
像迷你档这样的markdown编辑器可以直接把图片文件拖到文章中,也可以粘贴图片文件,图片数据。如果粘贴的是图片数据,会自动在编辑器的管理目录中创建一个图片文件保存数据,并用上面的图片格式插入到文章中。
链接的写法
可用下面的格式在文章中插入链接:
[链接名](URL或者文件路径)
例如[Google](https://www.google.com)
,此时点击Google会跳转到Google的官网。
“
和前面的图片写法比较,可以看出什么不同?答案是链接没有前面的惊叹号。链接也可以和红字,斜体,粗体,删除线等混合使用,也可以用在标题中。
链接本地文件
除了可以链接网址外,还可以链接本地文件,例如[绿石](C:WindowsGreenstone.bmp)
,要注意前面加惊叹号和不加惊叹号的区别,加了惊叹号会把它当图片处理,如果是本软件支持的图片格式,会在文章中显示它;不加惊叹号会把它当链接处理,点击它会打开文件位置。文件路径可以是绝对路径,也可以是文章的相对路径。
链接其它文章
通过链接其它文章,可以实现在文章间的跳转。例如文章A中一个话题在文章B中有更详细的展开讨论,可以在文章A中使用一个跳转到文章B的链接,和前面的链接本地文件一样的格式,例如:[什么是markdown](what_is_markdown.html)
。
段落锚点
通过在链接文章后面加上#段落名
,可以实现跳转到文章的指定段落。段落名是此段落的标题,可以是一级标题,二级标题,直至六级标题。
如果要跳转到本文内的锚点,可以省略文章名,例如[跳转到本文关于标题的介绍](#标题)
。
“
段落锚点可以是任意一级标题,如果文章中有两个同名标题,那么只能设置前一个为锚点,点击后只会跳转到前一个段落上。
下面将介绍列表,表格,代码段,引用段的写法。
分隔线的写法
分隔线是网文中用得很多的一种元素,可以表达的意思有文章补充,参考来源,签名等,在word中,可以在空行输入三个-
,或者三个=
,或者三个~
等等,再按回车插入分隔线。markdown也是一样,只要在一行内打出三个或以上的*
、-
、_
就可以在文章中画一条横线:
语法 | 效果 |
---|---|
*** |
|
--- |
|
___ |
“
Word中的分隔线根据不同的符号,可以是直线型,双直线型,波浪线型等等,markdown中只有一种,但是可以用css设置线型。
引用段的写法
引用名人名言,或者其他人在其它文章中的话语,一般将其放在一个引用段中。word在样式选择时可以选择引用类型,而markdown创建引用段也很方便,只要在段首以一个<
+空格开头就可以了。
语法 | 效果 |
---|---|
< 奥林匹克运动会发源于两千多年前的古希腊,因举办地在奥林匹亚而得名。古代奥林匹克运动会停办了1500年之后,法国人顾拜旦于19世纪末提出举办现代奥林匹克运动会的倡议。1894年成立奥委会,1896年举办了首届奥运会,1924年举办了首届冬奥会,1960年举办了首届残奥会,2010年举办了首届青奥会,2012年举办了首届青冬奥会。 |
奥林匹克运动会发源于两千多年前的古希腊,因举办地在奥林匹亚而得名。古代奥林匹克运动会停办了1500年之后,法国人顾拜旦于19世纪末提出举办现代奥林匹克运动会的倡议。1894年成立奥委会,1896年举办了首届奥运会,1924年举办了首届冬奥会,1960年举办了首届残奥会,2010年举办了首届青奥会,2012年举办了首届青冬奥会。 |
“
引用段也是文本段落,上一篇介绍的各种文本格式,图片,链接等等同样可以用在引用段内,而且可以用css设置不同的显示样式。
列表的写法
如果多个段落有并列关系,可以用列表的形式呈现,显得更加整洁。在markdown中,连续的每个段落在段首以一个*
+空格开头就形成了一个列表。
语法 | 效果 |
---|---|
* 田径:田径是体育运动中最古老的运动。 * 赛艇:运动员背向前进方向划水的一项划船运动。 * 自行车:起源于欧洲。1896年列为首届奥运会比赛。 |
田径:田径是体育运动中最古老的运动。赛艇:运动员背向前进方向划水的一项划船运动。自行车:起源于欧洲。1896年列为首届奥运会比赛。 |
如果多个段落有并列关系,而且逻辑上有顺序关系,可以用有序列表的形式呈现。和word一样,连续的每个段落在在段首以数字+.
+空格开头就形成了一个有序列表。
语法 | 效果 |
---|---|
1. 田径:47枚金牌 2. 游泳:44枚金牌 3. 自行车:18枚金牌 |
田径:47枚金牌游泳:44枚金牌自行车:18枚金牌 |
“
和word一样,段首的数字不需要是连续的,比如三个段落分别以
1.
、1.
、1.
开头,或者分别以1.
、3.
、5.
开头,最终得到的效果都是1.
、2.
、3.
的序号,markdown会自动计算列表序号。
如果列表中的某一项可以继续展开,还可以嵌入其它列表,也就是多级列表。在上面两种段首前加上三个空格就可以了,word很类似。
语法 | 效果 |
---|---|
1. 田径:47枚金牌2. 游泳:44枚金牌 1. 泳道游泳:34枚金牌 2. 跳水:8枚金牌 3. 花样游泳:2枚金牌3. 自行车:18枚金牌 1. 山地:2枚金牌 2. 公路:4枚金牌 3. 场地:10枚金牌 4. BMX小轮车:2枚金牌 |
田径:47枚金牌游泳:44枚金牌泳道游泳:34枚金牌跳水:8枚金牌花样游泳:2枚金牌自行车:18枚金牌山地:2枚金牌公路:4枚金牌场地:10枚金牌BMX小轮车:2枚金牌 |
“
列表段也是文本段落,上一篇介绍的各种文本格式,图片,链接等等同样可以用在列表段内,而且可以用css设置不同的显示样式。
表格的写法
markdown中并不直接支持很复杂的表格,通常就是m行*n列的普通表格,可以有表头,也就是(m数据行+1表头行)*n列。做法也和word中大相径庭,是通过|
字符和-
字符“画”表格。比如下面的字符表格:
|届数 |赛事名称 |举办国家|主办城市|举办时间 ||------|----------------|---|---|---------------------|
|第01届|1896年雅典奥运会|希腊|雅典|1896年04月06日-1896年04月15日|
|第02届|1900年巴黎奥运会|法国|巴黎|1900年05月20日-1900年10月28日|
|第03届|1904年圣路易斯奥运会|美国|圣路易斯|1904年07月01日-1904年11月23日|
|第04届|1908年伦敦奥运会|英国|英国|1908年04月27日-1908年10月31日|
就会创建如下表格:
届数 | 赛事名称 | 举办国家 | 主办城市 | 举办时间 |
---|---|---|---|---|
第01届 | 1896年雅典奥运会 | 希腊 | 雅典 | 1896年04月06日-1896年04月15日 |
第02届 | 1900年巴黎奥运会 | 法国 | 巴黎 | 1900年05月20日-1900年10月28日 |
第03届 | 1904年圣路易斯奥运会 | 美国 | 圣路易斯 | 1904年07月01日-1904年11月23日 |
第04届 | 1908年伦敦奥运会 | 英国 | 英国 | 1908年04月27日-1908年10月31日 |
“
|
字符和-
字符分别表示表格的竖边和横边,其中横边只要第一行以下有就可以了,第一行就是表头。而且并不需要工整地对齐,只要记得一个竖线分隔一个单元格就可以了。
表格内对齐在第二行,也就是纯|
字符和-
字符组成的表头/表数据分隔行内控制,如果一个单元格是以:
开头并且以:
结尾,那么此列是居中,仅以:
开头是左对齐,仅以:
结尾是右对齐,例如:
| 左对齐 | 居中 | 右对齐 || :------------ |:---------------:| -----:|
| col 3 is | some wordy text | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
就会创建如下表格:
左对齐 | 居中 | 右对齐 |
---|---|---|
col 3 is | some wordy text | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
“
如果某个单元格没有设置对齐方式,也就是没有
:
字符,那么此列是默认对齐方式,由css设置,通常是左对齐。
最后说一说另一种常见的表格,没有表头,全部由数据组成,也就是无头表格。无头表格就是第一行的单元格内不能有空格以外的字符,比如上面的表格只要删掉“左对齐”,“居中”,“右对齐”:
| | || :------------ |:---------------:| -----:|
| col 3 is | some wordy text | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
就会创建如下表格:
col 3 is | some wordy text | $1600 |
---|---|---|
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
“
表头单元和数据单元内都可以用上一篇介绍的各种文本格式,图片,链接,而且可以用css设置不同的显示样式。
代码段的写法
程序员写技术文章通常要在里面插入一段一段的代码,代码段在word内没有直接的处理方式,而在markdown中则非常方便,由两个由三个```字符(反引号,键盘上Esc健以下,数字1左边的键)组成的行包起来的部分就是程序代码,如:
语法 | 效果 |
---|---|
int main(int argc, char *argv[]) { printf("Hello, world!n"); } |
int main(int argc, char *argv[]) { printf("Hello, world!n"); } |
通常markdown编辑器还会允许设置代码段的语法,例如常见的C++
、Java
、Python
等等,迷你档可以设置三十余种语法,设置了语法后就可以显示代码内的语法信息:
语法 | 效果 |
---|---|
````c++` int main(int argc, char *argv[]) { printf("Hello, world!n"); } ````` | int main(int argc, char *argv[]) { printf("Hello, world!n"); } |
“
代码段内不能使用一篇介绍的各种文本格式,图片,链接,所有的文本都是直接文本。
markdown的全部基本写法都介绍完了,今后还会介绍更多的扩展写法。
以上就是我在写公众号和知乎上,经常使用的Markdown语法,真的非常好用,推荐给所有人使用,我们可以把Markdown当作一种文本编辑器来用,在电脑上记一些程序呀,或者写论文时的一些想法呀,都是非常可以的。随着一些Markdown写作软件的收费,我相信之后VSCode会更加受欢迎。
发表评论