Markdown语法

Author Avatar
子语 2017 - 09 - 23
  • 在其它设备中阅读本文章

Markdown是一种轻量级的标记语言,语法简单,由一些符号组成,这些符号作用一目了然,实现易读易写的目标。Markdown兼容HTML,即你可以直接在文本中添加HTML语言,但是你不能在HTML区块标签间使用Markdown语法。

Markdown语法

区块元素

段落与换行

一个Markdown段落是由一个或多个连续的文本行组成的。在Markdown中是无法使用空格或制表符来缩进的,因为其默认一个空格就是一个空行。

标题

Markdown支持两种标题的语法,类Setext形式和类Atx形式,接下来介绍的类Atx形式:该形式是在行首插入1到6个#,对应1到6级标题。

# 这是H1
## 这是H2
...
###### 这是H6

区块引用Blockquotes

Markdown标记区块引用方式如下:

> 文本内容。
>> 文本中也可以使用嵌套引用,只要根据层次加上不同数量的>

在引用的区域中,也可以使用其他的Markdown语法。

列表

Markdown支持有序列表和无序列表。无序列表使用星号减号加号作为列表标记:

* red
- green
+ blue

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

1. red
2. green
3. blue

如果列表项目间用空行分开,在输出HTML时Markdowm就会将内容用段落标签包起来,即:

	* blue

	*red

会被转换为:

<ul>
<li><p>blue</p></li>
<li><p>red</p></li>
</ul>

如果要在列表项目中放入引用,就需要缩进

* red
	> this is color

如果要放入代码块,那就需要连续缩进两次。并且为避免行首出现数字-句号-空白,应在句号前加反斜杠。

代码区域

要在Markdown中建立代码区块很简单,只需要缩进4个空格或一个tab即可。

分隔线

你可以在一行使用三个以上的星号减号下划线来建立一个分隔线,行内不能有其他东西。你可以在星号或减号中间插入空格。

星号:  * * *
减号:  - - -
下划线:_ _ _ 

区段元素

链接

Markdown支持两种形式的链接语法:行内式和参考式。建立一个行内式的链接,只要在方块括号后面紧接着圆括号插入链接即可,如果想要加上链接的title文字,只要网址后面用双引号把title文字包起来即可。

[example](https://www.baidu.com "Title")

强调

Markdown使用星号和下划线标记强调,被*_包围的字词会被转为用<em>标签包围,而用两个*_包起来,则变为<strong>

*强调*
_强调_
**强调**
__强调__

如果只想在文字前后插入普通的星号或下划线,可以使用反斜杠:

\*文字\*

代码

如果要标记一小段行内代码,可以使用反引号把它包起来,例如:

`printf()`

如果要在代码中插入反引号,你可以用多个反引号开启或结束代码区段:

`` (`) `` 将变为  <p><code>(`)</code></p>

图片

插入图片有两种方式:行内式和参考式

![替代图片的文字](/path/to/img.jpg "文字")

结束

感谢您的阅读,如果您有什么问题,请在下方留言,谢谢。

This blog is under a CC BY-NC-SA 3.0 Unported License
本文链接:http://yov.oschina.io/article/语言/Markdown语法/