MarkDown语法说明

written on Sun 27 March 2016 by

本篇博文参考这里

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面。

标题语法

形式一:

标题1
====(至少一个,同行不能有其他字符)
标题2
----

效果:

标题1

标题2

形式二:

示例:
# 标题1 #(可以闭合,也可以不闭合,闭合的话数量也不一定要相同)
## 标题2
### 标题3
#### 标题4
##### 标题5
###### 标题6

效果:

标题1

标题2

标题3

标题4

标题5
标题6



段落和换行

空格:多个空格或者一个回车符(只能显示一个空格)

多空格:\ 

段内换行:双空格 + 回车符

另起一段:双回车符

多空行: \

分隔线语法

三个以上 *  -  _ 

* * *

***

*****

- - -

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

效果:






加粗和斜体

使用一个 *  _ 来包围词句,相当于用 <em> 标签包围(内部就是这样转化的);
使用两个 *  _ 包起来的话,则相当于使用 <strong>
示例:
**加粗** __加粗__
*斜体* _斜体_

效果:

加粗 加粗
斜体 斜体

列表语法

无序列表

一个星号 / 一个加号 / 一个减号 + 若干个空格 + 列表项内容
条目之间的空行会作用到所有条目
* 条目1         + 条目1        - 条目1
* 条目2    or   + 条目2    or  - 条目1
* 条目3         + 条目3        - 条目1

效果:

  • 条目1
  • 条目2
  • 条目3


有序列表

一个数字 + 一个英文句点 + 若干个空格 + 列表项内容
1. 条目1
2. 条目2
3. 条目3
33.条目4 (数字可以乱写,自动从1开始排列)

效果:

  1. 条目1
  2. 条目2
  3. 条目3
  4. 条目4

注意:

  1. 每个列表条目下都可以包含多个段落,但这些段落都必须缩进 4 个空格或 1 个制表符

  2. 如果要在列表条目内放进引用,那 > 就需要缩进

  3. 如果要在列表项内放代码区块的话,该区块就需要缩进两次,也就是8个空格或是2个制表符

区块引用语法

> 引用d段落
(段落里每一行有可以加 > 也可以只在段首加)

效果:

引用段落


引用可以嵌套
示例:
> 父引用
> 
> > 子引用
> 
> 父引用

效果:

父引用

子引用

父引用

引用内MarkDown语法依然有效
> ## 这是一个标题。
> 
> 1. 这是第一个列表项。
> 2. 这是第二个列表项。
> 
> 这是一个代码例子:
> 
>     printf("Hello, Minmin!\n"); return 0;

效果:

这是一个标题。

  1. 这是第一个列表项。
  2. 这是第二个列表项。

这是一个代码例子:

printf("Hello, Minmin!\n"); return 0;

链接语法

形式一:自动链接(可点击的URL和Email)

如果链接的文字就是一个网络地址或者是邮箱地址直接使用<url>
示例
<https://www.baidu.com>
<importcjj@gmail.com>

效果:
https://www.baidu.com

importcjj@gmail.com


形式二:普通文本链接

[链接文字](链接URL ‘可选的链接title)  注:我的blog有问题,这里的‘ 其实是英文单引号
[链接文字](链接URL "可选的链接title")
[链接文字](链接URL (可选的链接title))
title: 加上title后,你用鼠标移到该链接文字时就会显示title文字,可以把它当作一种提示信息来用
示例:
欢迎光临我的[博客](www.importcjj.com)

效果:

欢迎光临我的博客


形式三:参考式链接

[链接文字][链接id]
\[链接id]: 真正的链接URL "可选的title"           注:去掉反杠!
示例:
[我的博客][id]
\[id]: www.baidu.com "jiaju的博客"

效果: 我的博客

图片语法

![alt文本](https://img10.3lian.com/sc6/show02/67/27/02.jpg)

效果:

alt文本

代码语法

行内代码

`代码`  反引号
`print "hello world"`

代码区块

要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以。

表格语法

简洁写法:

示例:
|姓名  |年龄|性别   |   我们可以指定单元格的对齐方式
|---  |----|----- |   |:---|           靠左
|John |22  |male  |   |---| or |:---:| 居中
|Tom  |20  |male  |   |---:|           靠右
|aliss|24  |female|

效果:

姓名 年龄 性别
John 22 male
Tom 20 male
aliss 24 female

总结

注意:上述乃基本语法,而且由于MarkDown的编辑器各不相同,对于原生MarkDown都有扩展,实际使用的时候情况很多,自己多多尝试就能熟练使用了。

This entry was tagged on #markdown

comments powered by Disqus
 

Tags