简明 MarkDown 教程

简明 MarkDown 教程

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。

MarkDown  是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。MarkDown 的语法简洁明了、学习容易,而且功能比纯文本更强,因此广泛应用于网站,文档编辑等领域。下面一步一步教你掌握 MarkDown。

标题

在 MarkDown 中,如果我们要输入一个标题的话,我们首先需要输入一个 # 号,然后输入一个空格,接下来输入标题内容就好了。

语法


# 这是一级标题
## 这是二级标题 
### 这是三级标题 
#### 这是四级标题 
##### 这是五级标题 
###### 这是六级标题

粗体和斜体

在 MarkDown 中,如果我们要使用粗体的话,我们首先需要输入两个*号,然后输入需要粗体显示的内容,内容输入完成之后我们在输入两个*号。如果要使用斜体的话,我们需要首先输入一个*号,然后输入需要斜体显示的内容,完成之后再输入一个*号。

语法


**这是粗体**
*这是斜体*
***这是斜体加粗***

你也可以使用_代替*

效果展示

这是粗体 这是斜体 这是斜体加粗

引用文字

有时候我们在文章中需要引用一些别人说过的话,这时我们首先需要输入一个>号,然后输入一个空格,接下来输入标题内容就好了。

语法

> 原谅敌人要比原谅朋友容易。——狄尔治夫人

效果展示

原谅敌人要比原谅朋友容易。——狄尔治夫人

删除线

有时候我们输入了一些文字,但随着岁月的流逝,已经不再符合当下的环境,但是保留这些文字依然拥有一定的意义,这个时候我们就需要使用删除线了。MarkDown 中插入删除线的方式是,首先在需要添加删除线的文字之前输入两个~号,然后在删除线结束的地方输入两个~号。

语法


~~网页编辑器真的非常、很、超级难用~~,有了 MarkDown 之后,文本编辑再也不是意见烦心事了。

效果展示

网页编辑器真的非常、很、超级难用,有了 MarkDown 之后,文本编辑再也不是意见烦心事了。

分割线

为了排版美观,或者需要分割一些注释的内容,我们会用到分割线,在 MarkDown 中插入一条分割线是非常简单的,你只需要连续输入三个*-

效果展示


列表

写论点的时候通常都有很多条,这时我们就需要使用列表了。列表有两种形式,分别是有序列表和无序列表。所谓有序列表就是按照 1,2,3,4…… 排列的形式,而无序列表顾名思义就是没有顺序的列表,通常以点开头。

使用无序列表,我们首先需要输入一个*号,然后输入一个空格,接着输入内容。

输入有序列表,我们首先需要输入一个数字,接受输入一个.,然后输入一个空格,接着输入内容。

语法


无序列表:
 
- 我喜欢北京 
- 我也喜欢南京 
- 我还喜欢 

有序列表: 
1. 洗净的鱼切块,放盆里加适量盐,白胡椒粉,料酒和姜丝腌制半小时 
2. 腌制好的鱼放入适量淀粉拌均匀 
3. 锅内放油,要比平时炒菜的时候适当多些,油热时放入鱼块,小火煎到两面金黄捞出备用 
4. 葱,姜,蒜,切末。另起锅放油炒香姜,蒜,葱末 
5. 把煎好鱼块入锅炒匀 
6. 把酱油、蚝油、白糖、少许淀粉、醋和适量水调成汁(这个可以事先调好) 
7. 倒入炒锅内的鱼块里面。中小火烧至收汁 
8. 放入味精和喜欢的菜翻炒均匀即可。(家里面有蒜苗,我就放了些,也可以放葱,或是青椒等等)

效果展示

由于列表有两种形式,所以我们分开来展示效果。

无序列表

我最喜欢的城市:

  • 我喜欢北京
  • 我也喜欢南京
  • 我还喜欢

除了使用*号之外,你也可以使用-或者+

有序列表

红烧鱼的做法如下:

  1. 洗净的鱼切块,放盆里加适量盐,白胡椒粉,料酒和姜丝腌制半小时
  2. 腌制好的鱼放入适量淀粉拌均匀
  3. 锅内放油,要比平时炒菜的时候适当多些,油热时放入鱼块,小火煎到两面金黄捞出备用
  4. 葱,姜,蒜,切末。另起锅放油炒香姜,蒜,葱末
  5. 把煎好鱼块入锅炒匀
  6. 把酱油、蚝油、白糖、少许淀粉、醋和适量水调成汁(这个可以事先调好)
  7. 倒入炒锅内的鱼块里面。中小火烧至收汁
  8. 放入味精和喜欢的菜翻炒均匀即可。(家里面有蒜苗,我就放了些,也可以放葱,或是青椒等等)

有序列表使用相同的数字也没有关系,渲染之后会自动调整。

嵌套列表

在某些特殊的情况下,我们需要输入嵌套的列表。需要注意的是,目前大多数编辑器不支持有序,无序混合嵌套。所以嵌套列表请使用无序的方式。

嵌套列表语法


* 广东
	+ 广州
		- 白云区
		- 越秀区
		- 天河区
		- ...
	+ 深圳
	+ 惠州
	+ ...
* 江苏
	+ 南京
	+ 苏州
	+ 无锡
	+ ...
* 江西
	+ 南昌
	+ 九江
	+ 赣州
	+ ...

嵌套列表效果展示

  • 广东
    • 广州
      • 白云区
      • 越秀区
      • 天河区
      • ...
    • 深圳
    • 惠州
    • ...
  • 江苏
    • 南京
    • 苏州
    • 无锡
    • ...
  • 江西
    • 南昌
    • 九江
    • 赣州
    • ...

插入图片

在文本中插入图片是非常常用的功能了,而使用 MarkDown 插入图片也是非常的快捷,操作方式请看语法。

语法


![这里输入图片的名称](这里输入链接) 
![星空](D:\home_cover_1505654996151_ee57bf.jpg) 
![星空](https://example.com/example.jpg)

效果展示

简明 MarkDown 教程

关于图片路径,应尽量使用相对路径,这样兼容性会更好,并且支持多平台。

链接

如果你经常编辑文档的话,我想你一定少不了要插入链接。在 MarkDown 中,插入链接会让你感觉非常享受,整个过程都非常的顺。语法和插入图片比较相似,只是不需要`!`。具体语法请看语法部分

语法


[百度](https://www.baidu.com) 
[Google](https://www.google.com)

效果展示

相对于百度,我更喜欢使用Google来搜索。

表单

除了文字之外,表单也是很常用的。在 MarkDown 中使用表单稍显复杂,但由于重复部分多,所以其实也蛮简单的。首先是字段之间使用`|`分割。第二行格式固定,需要使用`|`加三条以上横线`–--`来定义当前字段的格式,详细请看下放的语法。

语法


|   姓名   |   性别   |   年龄   |
| :------  | :-----: | ------: |
|   张三   |   男     |   6   |
|   韩梅梅  |   女     |   18   |
|   李四    |   男     |   17   |

效果展示

姓名 性别 年龄
张三 6
韩梅梅 18
李四 17

注解

可以看到,如上示例中,第二行定义了表格的对齐方式,具体含义如下:

  • :----- 表示左对齐
  • :-----: 表示居中对齐
  • -----: 表示右对齐

这里横线并不限定长度,可根据排版的需要增减横线。

专题:Markdown

分享到 :
相关推荐