Markdown使用教程

什么是Markdown语言

Markdown是一门如同HTML一样的标记语言。它使用一些简单的标记来展现文档的不同格式,例如,本章节的标题我们就是使用这样的格式表示的:

# 什么是Markdown语言

这个展现出来的就是本章的标题。

为什么使用Markdown语言

  • 样式丰富
    使用Markdown语言,可以使文档拥有丰富的展现形式,各种不同的格式,十分适用于博客,文档等使用场景。
  • 简单易学
    通过上一节的例子我们会发现,Markdown语言明显比其他标记语言,如HTML,简单易学。在HTML中写标题样式是这样的:
<h1>什么是Markdown语言</h1>

可以很容易的看出比Markdown麻烦很多——Markdown只需要多一个字符就可以展示为标题,而HTML需要9个。
另外,Markdown也比HTML易学很多。HTML的教程动辄几百页,而Markdown只要一篇简短的教程就能搞定。

  • 版本控制友好
    如果只是因为有丰富的格式样式的话,我们为什么不选择Word呢?这里有两个原因。其中之一就是版本控制友好。(另一个原因是有很多在线编辑平台支持Markdown,但并不支持Word。)
    一般的版本控制系统都是基于文件字符的,而Word使用的是一种特殊的编码格式。因此,当你使用版本控制工具比对Word文件的版本的时候,你其实能够看到的只是一堆乱码。而如果你要去对比Markdown的文档时,则可以看到非常清晰的版本对比信息。
    Markdown语言的版本对比十分清晰
  • 使用广泛
    大多数的博客系统,如简书,wordpress等;和很多技术社区及文档平台,如github,图灵社区等都支持wordpress编辑模式。学会Markdown就可以让我们在这些平台上更容易地编辑出漂亮的文档。

在哪里实战操作

我们学习一个语言最好的方式就是实战。那么我们学习markdown语言要去哪里实战呢?您可以在网上搜索Markdown在线编辑器,一般这种编辑器都是左边写Markdown,右边就时时把样式展现出来的,十分方便。这样您就可以边看教程,边练习了。

语法

换行

Markdown中最基本的语法就是换行。在标准的Markdown中,输入一个回车是起不到换行的效果的:

第一行
第二行

在标准的Markdown中,这样的文本显示出来的是:

第一行 第二行

如果我想换行就必须在每行的末尾加两个空格,或使用两个回车起到换行的效果(两个回车的换行在展示中也会多一行)。
不过,很多平台,如简书,都支持一个回车直接换行。但是为了确保编写的Markdown有最好的兼容性。还是建议使用标准的Markdown语法进行换行。

标题

标题也是个十分常用的语法。Markdown中最多支持六级标题:

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

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

需要注意的是,标准的格式是 井号+空格+标题。有些Markdown编辑器支持井号后边不加空格也可以,但那是不标准的语法。

加粗

加粗语法一般有两种:

这样可以**加粗**。
这样也可以 __加粗__ 。

这样可以加粗
这样也可以 加粗

加粗的两种语法分别是前后加两个星号,或前后加两个下划线。需要注意的是,前后加两个下划线的写法,在标准的Markdown语法中是要前后加空格的。当然依旧有些编辑器可以省略前后的空格。

斜体

斜体语法一般也有两种:

这样可以*斜体*。
这样也可以 _斜体_ 。

这样可以斜体
这样可以 斜体

斜体的两种语法分别是前后加一个星号,或前后加一个下划线。需要注意的是,前后加一个下划线的写法,在标准的Markdown语法中是要前后加空格的。当然依旧有些编辑器可以省略前后的空格。

删除线

如果我们想明确的表达,不要某句话了或不要这么做,我们可以使用删除线:

~~我要删掉这个。~~

我要删掉这个。

删除线的写法就是前后加两个波浪号。

引用

如果我们想引用一段文字我们可以这样:

>黄鸟于飞,
>集于灌木,
>其鸣喈喈。

黄鸟于飞,
集于灌木,
其鸣喈喈。

使用引用,就是在你引用的文字前边加上小于号。

引用代码

引用代码分为两种模式,一种是行内引用,一种是多行引用。
我们先来说行内引用:
使用'public static void main()'来声明入口函数。
使用public static void main()来声明入口函数。
我们在要引用的代码前后都加一个撇号就可以在行内引用代码了 。
我们再来说引用多行代码的方法:
'''
public static void main(){

}
'''

public static void main(){

}

引用多行代码的方式就是在代码上下分别加三个撇号。

列表

列表一般有两种情况,一种是无序列表,一种是有序列表。
使用无序列表的方法如下:

- 列表
- 列表
- 列表
  • 列表
  • 列表
  • 列表

无序列表的使用方式是,减号+空格+文字。空格务必不能丢掉。
有序列表的使用只是把减号换成了数字标号:

1. 列表
2. 列表
3. 列表
  1. 列表
  2. 列表
  3. 列表

有序列表的语法是 编号+点+空格+文字。也许你会奇怪,这样写有什么意义呢。
那我们换一种写法。

1. 列表
1. 列表
1. 列表
  1. 列表
  2. 列表
  3. 列表

你会发现,它展现的还是123。
除了无序列表和有序列表,列表还有一个概念就是多级列表:

- 一级列表
一级列表内容
  - 二级列表
二级列表内容
    - 三级列表
三级列表内容
  • 一级列表
    一级列表内容
    • 二级列表
      二级列表内容
      • 三级列表
        三级列表内容

只需要在列表前边加个tab就可以了。

链接

下面为大家介绍如何使用Markdown加入链接:

这是百度的[链接](http://www.baidu.com.cn)

这是百度的链接
这是最普通的加入链接的方式,中括号内是会触发链接的文字,小括号内是链接的地址。
还有一种页内链接,可以跳转到指定的标题:

跳到加粗的链接:[链接](#加粗)

跳到加粗的链接:链接
只要在写链接的小括号中写上 井号+标题,即可。但是有的Markdown编辑器对页内链接功能支持并不友好,比如简书。
当然,链接还支持相对路径链接。

表格

表格的写法如下:

|表头一|表头二|表头三|
|-|-|-|
|内容一|内容二|内容三|
|内容一二三|内容四五六|内容七八九|
表头一 表头二 表头三
内容一 内容二 内容三
内容一二三 内容四五六 内容七八九
表格也可以设置左对齐,右对齐和居中:
|左对齐|右对齐|居中|
|:-|-:|:-:|
|内容一|内容二|内容三|
|内容一二三|内容四五六|内容七八九|
左对齐 右对齐 居中
内容一 内容二 内容三
内容一二三 内容四五六 内容七八九

引入图片

引入图片的方法如下:

![百度Logo](http://www.baidu.com/img/baidu_jgylogo3.gif)

百度Logo
叹号开头,中括号中为图片的alt,小括号中为图片的地址。

以上就是标准Markdown语言的基本用法。Markdown在不同的平台中还有不同的功能拓展,大家可以在使用那些平台的时候再去查阅相关的帮助文档。

posted @ 2018-06-01 11:19  梅葆瑞  阅读(1197)  评论(1编辑  收藏  举报