Markdown基本使用

Markdown介绍

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。最终通过相应的编辑器或者脚本转换成html用于页面渲染。

Markdown 的目标是实现「易读易写」。Markdown 是一个 Web 上使用的文本到HTML的转换工具,可以通过简单、易读易写的文本格式生成结构化的HTML、PDF文档。目前 github、Stackoverflow 等网站均支持这种格式。

接下来讲解Markdown的基本语法,主要分为区块元素和区段元素。

区块元素

标题

Markdown支持6种级别的标题,对应html标签 h1 ~ h6 效果如下:

区块引用

Markdown提供了一个特殊符号>用于段首进行强调,被强调的文字部分将会高亮显示。区块引用也可以嵌套无限个。

1
2
>引用的内容
>>两个引用的内容

效果如下:

引用的内容

第二个引用的内容

列表

Markdown 支持有序列表和无序列表。

无序列表使用星号、加号或是减号作为列表标记:

1
2
3
*   Red
* Green
* Blue

等同于:

1
2
3
+   Red
+ Green
+ Blue

也等同于:

1
2
3
-   Red
- Green
- Blue

效果如下:

  • Red
  • Green
  • Blue

有序列表则使用数字接着一个英文句点:

1
2
3
1.  Bird
2. McHale
3. Parish

效果如下:

  1. Bird
  2. McHale
  3. Parish

代码区块

和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块,通常这些区块我们并不希望它以一般段落文件的方式去排版,而是照原来的样子显示,Markdown 会用

 标签来把代码区块包起来。

要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,例如,下面的输入:

1
2
3
这是一个普通段落:

这是一个代码区块。

效果如下:
这是一个普通段落:

1
这是一个代码区块。

分割线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:

1
2
3
4
5
6
7
8
9
* * *

***

*****

- - -

---------------------------------------

效果如下:






区段元素

链接

Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。参考式写法比较麻烦一般采用行内式的方式。

语法:

1
2
[超链接显示名](超链接地址 "超链接title")
[百度](http://baidu.com/ "baidu")

效果如下:
百度

图片

语法:

1
2
![图片alt](图片地址 ''图片title'')
![M图片](http://www.newasp.net/attachment/soft/2015/0713/085610_78002493.png "M")

M图片

强调

Markdown 使用星号(*)和底线(_)、破折号(~)作为标记强调字词的符号

  • 加粗

要加粗的文字左右分别用两个*号包起来

1
**加粗**

会转换成:

1
<strong>加粗</strong>

加粗

  • 斜体

要倾斜的文字左右分别用一个*号包起来

1
*斜体*

斜体

  • 斜体加粗

要倾斜和加粗的文字左右分别用三个*号包起来

1
***斜体加粗***

斜体加粗

  • 删除线

要加删除线的文字左右分别用两个~~号包起来

1
~~删除线~~

删除线

  • 下划线

要加下划线的文字左右分别用号包起来

1
<u>下划线</u>

下划线

  • 代码

语法:
单行代码:代码之间分别用一个反引号包起来

1
`代码内容`

会转成:

1
<p><code>代码内容</code></p>

代码内容

代码块:代码之间分别用三个反(’’’)引号包起来,且两边的反引号单独占一行

1
2
3
代码...
代码...
代码...

表格

语法:

1
2
3
4
5
6
7
8
9
表头|表头|表头
-|:-:|-:
内容|内容|内容
内容|内容|内容

第二行分割表头和内容
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右

示例:

1
2
3
4
5
序号|姓名|年龄
-|:-:|-:
1|张三|18
2|李四|19
3|王五|20
序号 姓名 年龄
1 张三 18
2 李四 19
3 王五 20

其他

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号(转义字符),例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 标签),你可以在星号的前面加上反斜杠:

1
\*literal asterisks\*

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

1
2
3
4
5
6
7
8
9
10
11
12
\   反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
0%