参考资料:markdown中文文档:
markdown也用了一段时间了,今天系统的看一下常用语法,总结如下:
标题
Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。
Setext是底线形式, 利用=(最高阶标题)和-(第二阶标题),如:
This is an H1
=============
This is an H2
-------------
任何数量的 = 和 - 都可以有效果。
Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,例如:
# 这是 H1
## 这是 H2
###### 这是 H6
你可以选择性地「闭合」类 atx 样式的标题,这纯粹只是美观用的,若是觉得这样看起来比较舒适,你就可以在行尾加上 #,而行尾的 # 数量也不用和开头一样(行首的井字符数量决定标题的阶数):
# 这是 H1 #
## 这是 H2 ##
### 这是 H3 ######
区块引用
Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。如果你还熟悉在 email 信件中的引言部分,你就知道怎么在 Markdown 文件中建立一个区块引用,那会看起来像是你自己先断好行,然后在每行的最前面加上 > :
> 第一行引用
> 第二行引用
Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 > :
> This is the first level of quoting.
>
> > This is nested blockquote.
引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:
> ## 这是一个标题。
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一些例子代码:
>
> return shell_exec("echo $input | $markdown_script");
列表
Markdown 支持有序列表和无序列表。
无序列表使用星号、加号或是减号作为列表标记:
* Red
* Green
或者
+ Red
+ Green
或者
- Red
- Green
有序列表则使用数字接着一个英文句点:
1. Bird
2. McHale
3. Parish
很重要的一点是,你在列表标记上使用的数字并不会影响输出的 HTML 结果,上边的数字不论怎么写,都会按顺序输出。
代码区块
要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,例如,下面的输入:
这是一个普通段落:
这是一个代码区块
分割线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
* * *
***
*****
- - -
------------------------------------
链接
Markdown 支持两种形式的链接语法:
[链接内容](链接url"链接hover时的title")
例如:
This is 链接内容 inline link.
强调
Markdown 使用星号()和底线(_)作为标记强调字词的符号,被 或 _ 包围的字词会被转成用 标签包围,用两个 * 或 _ 包起来的话,则会被转成 ,例如:
//一个是斜体
*single asterisks*
_single underscores_
//两个是加粗
**double asterisks**
__double underscores__
但是如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号。
代码
如果要标记一小段行内代码,你可以用反引号(esc下边那个键)把它包起来(`),例如:
Use the `printf()` function.
Use the printf()
function.
图片
Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。
行内式的图片语法看起来像是:
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")
- 一个惊叹号 !
- 接着方括号,里边是图片的替代文字
- 接着普通括号,里边是图片地址。后边还可以用引号包住,加上”title”文字
参考式的图片语法则长得像这样:
![Alt text][id]
[id]: url/to/image "Optional title attribute"
到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 标签。
自动链接
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用尖括号包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:http://example.com/
<http://example.com/>
转为:
<a href="http://example.com/">http://example.com/</a>