Markdown 的使用

Markdown 是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。

Markdown语法介绍

段落与换行

Markdown 中的段落指连续的一段文字,编写时段落之间用至少一个空行隔开,段落内多个空格将被视为一个空格,段首不支持缩进。

如果想要在显示时显示多个空行,可以插入 <br/> 来实现,注意的是,插入的 <br/> 应与前后的段落中间至少空一行。

标题

这是最为常用的格式,在平时常用的的文本编辑器中大多是这样实现的:输入文本、选中文本、设置标题格式。

Markdown支持两种类型的标题,例如:

//类型 1
这是一级标题
==========
这是二级标题
----------

//类型 2
# 这是一级标题
## 这是二级标题
...
###### 这是六级标题

从上面可以看出类型 1 是在标题下面插入 = 或者 - 来标识标题等级,但局限是其只能表示两个级别的标题。

类型 2 是在标题前面插入 1 - 6 个 # ,表示 6 个等级的标题,这是比较推荐的用法。

注:# 和「一级标题」之间建议保留一个字符的空格,这是最标准的 Markdown 写法。

列表

列表格式也很常用,在 Markdown 中,你只需要在文字前面加上 -、+或 * 就可以了,例如:

- 文本1
- 文本2
- 文本3

上面的 - 可以用 +、*替换。需要注意的是,- 等符号与后面的文字至少空一格空格。

如果你希望有序列表,
也可以在文字前面加上 1. 2. 3. 就可以了,例如:

1. 文本1
2. 文本2
3. 文本3

同无序列表一样,标记符号与后面的文字至少空一格空格。但编辑时的数字对显示无影响。

代码区块

缩进 4 个空格,需要注意的是,每行代码都需要至少缩进 4 个空格,不能像段落一样采用首行标记的偷懒写法,一个代码区会一直持续到没有缩进 4 个空格的那一行。

也可以用一对三个连续的撇号 ` 来包裹代码段,例如:

这是一个代码区块。

有的解释器还能根据代码的语言从而给代码加上语法高亮,例如:

function func() {}

分割线

使用三个及以上的 *、 -或 _来表示一个分割线,符号不能混用,符号之间可以插入多个空格。需要注意的是,使用 - 来插入分割线时需要与上一个段落至少空一行,否则 Markdown 会将上一行文字解释为二级标题。

表格

表格是 Markdown 比较复杂的一种表示,例如:

| Table | Col1 | Col2 |
| ----- |:----:| ----:|
| Row1  | 1-1  | 1-2  |
| Row2  | 2-1  | 2-2  |
| Row3  | 3-1  | 3-2  |

注:上面第二行中的点代表对齐方式,分别是默认(居左)、居中、居右。

超链接

Markdown 中有三种方式实现超链接,例如:

//方式 1
[百度](http://www.baidu.com)

方式 1 较为常用,也可以为链接的文字加上提示文字,只要在括号中超链接加上空格后添加提示内容即可,例如:

[百度](http://www.baidu.com "这是提示文字")

方式 2 由链接文字和链接地址组成,不同的是两者均由 [] 包裹。链接地址的格式为:

  • 方括号,里面输入链接地址;
  • 紧接着是一个冒号;
  • 冒号后面至少一个空格;
  • 链接地址;
  • 若有提示文字,空格后用引号或者括号包裹提示文字。

下面是完整示例:

//方式 2
[百度][Baidu-url]
[Baidu-url]: http://www.baidu.com

第三种方式是用 <> 来包裹 URL。

//方式 3
<http://www.baidu.com>

加粗和斜体

Markdown 使用 * 和 _ 来表示粗体和斜体,例如:

//加粗
**这是加粗文字**
__这也是加粗文字__

//斜体
*这是斜体文字*
_这也是斜体文字_

被偶数个 * 或 _ 包裹的文字显示加粗效果,被奇数个包裹的为倾斜效果。

需要注意的是,* 和 - 要成对出现,不能混合使用,也不能只出现一个。同时,标识符号要与标识的文字紧挨着,符号与符号之间、符号文字之间不能有任何空格。

代码

使用 ` (撇号) 来包裹一小段代码,例如:

'hello world'

若想在代码中添加撇号,可以使用多个撇号包裹里面需要添加的撇号,但注意里面的连续的撇号数量不能超过外面的数量,例如:

//显示一个撇号
`` ` ``

图片

图片的插入方式跟超链接前两种插入方式类似,例如:

//方式 1
![如果图片不能显示,就显示这段文字](图片 url)

//方式 2
![如果图片不能显示,就显示这段文字][Image-url]
[Image-url]: 图片url "这是提示文字"

反斜杠

我们经常需要在文章中插入一些特殊符号,而这些符号恰好是前面所讲的标识符号,可以在特殊符号前插入  来直接显示符号,而不让 Markdown 来将其解释为标识符号。

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

Markdown编辑器

支持Markdown的编辑器有好多,功能也不完全一致,有的是用来进行基本的写作,有的是用来写代码的,有的甚至只是博客平台配套的编辑器。

我个人用过一个都很不错,在这儿推荐一下

windows

  • Markdown Pad 2(Pro版要收费,网上有注册码)
  • Atom (个人主推,免费,颜值高,还可以安装各式各样的插件)

Mac

  • MacDown

欢迎大家收藏我的博客,我会努力更新更多的作品的,给自己加个油!

猜你喜欢

转载自www.cnblogs.com/noahcode/p/10253515.html