Markdown语法说明
HTML表格(简书不生效)
这是一个普通段落。
<table>
<tr>
<td>Foo</td>
</tr>
</table>
这是另一个普通段落。
特殊符号
&
©
AT&T
<
4 < 5
<a href="http://www.baidu.com">Baidu</a>
<br />
区块元素
段落和换行
一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行。
每个换行都转换为
<br />
第1行
第2行
第3行
第4行
标题
This is an H1
This is an H2
这是 H1
这是 H2
这是 H6
区块引用 Blockquotes
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.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
<br />
This is the first level of quoting.
This is nested blockquote.
Back to the first level.
列表
无序列表
无序列表使用星号、加号或是减号作为列表标记:
- Red
- Green
- Blue
有序列表
- Bird
- McHale
- Parish
<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>
列表项目标记 -- 缩进
- indent 0
- indent 1
- indent 2
- indent 3
- indent 4
* indent 10
普通缩进
indent 4
列表项目之间空行
-
Bird
-
Magic
列表项目包含段落(每个项目下的段落都必须缩进 4 个空格或是 1 个制表符)
-
This is a list item 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. Donec sit amet nisl. Aliquam semper ipsum
sit amet velit. -
Suspendisse id sem consectetuer libero luctus adipiscing.
列表项目内放进引用,>需要缩进:
- A list item with a blockquote:
This is a blockquote
inside a list item.
要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:
-
一列表项包含一个列表区块:
<代码写在这>
代码区块
Markdown会用 <pre>
和 <code>
标签来把代码区块包起来。
缩进 4 个空格或是 1 个制表符,代码区块前要有一个以上的空行。
这是一个普通段落:
这是一个代码区块。
在代码区块里面, & 、 < 和 > 会自动转成 HTML 实体:
<div class="footer">
© 2004 Foo Corporation
</div>
分隔线
用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西,可以在星号或是减号中间插入空格。
星号分隔线 ***
减号分隔线 ---
底线分隔线 _ _ _
区段元素
链接
链接文字都是用 [方括号] 来标记。
1. 行内式
在方块括号后面紧接着圆括号并插入网址链接:
This is an example inline link.
This is [an example](http://example.com/ "Title") inline link.
链接到同样主机的资源,可以使用相对路径:
See my About page for details.
See my [About](/about/) page for details.
2. 参考式
链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记:
This is [an example] [id] reference-style link.
This is [an example] [id] reference-style link.
接着,在文件的任意处,你可以把这个标记的链接内容定义出来:
[id]: http://example.com/ "Optional Title Here"
[id]: http://example.com/ "Optional Title Here"
链接内容形式:
方括号(前面可以选择性地加上至多三个空格来缩进),里面输入链接文字
接着一个冒号
接着一个以上的空格或制表符
接着链接的网址
选择性地接着 title 内容,可以用单引号、双引号或是括弧包着
链接的定义可以放在文件中的任何一个地方,我比较偏好直接放在链接出现段落的后面,你也可以把它放在文件最后面,就像是注解一样。
隐式链接标记可以省略指定链接标记,链接标记会视为等同于链接文字:
[Google][]
[Google][]
然后定义链接内容:
[Google]: http://google.com/
[Google]: http://google.com/
链接辨别标签可以有字母、数字、空白和标点符号,但是并不区分大小写。
强调
被 * 或 _ 包围的字词会被转成用 <em>
标签包围,用两个 * 或 _ 包起来的话,则会被转成 <strong>
,例如:
single asterisks
single underscores
double asterisks
double underscores
如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号。
简书有点差别:同一行文本只有一个 * 或 _ 时,才符合!
代码区段
行内代码用反引号(`)包起来
Use the printf()
function.
在代码区段内插入反引号用多个反引号来开启和结束代码区段:
There is a literal backtick (`) here.
代码区段的(起始和)结束端放入一个空白,可以在区段的一开始就插入反引号:
A backtick-delimited string in a code span: ```foo` ``
在代码区段内,& 和尖括号都会被自动地转成 HTML 实体:
Please don't use any `<blink>` tags.
`—` is the decimal-encoded equivalent of `—`.
图片
Markdown 使用一种和链接很相似的语法来标记图片,允许两种样式: 行内式和参考式。
1. 行内式
Alt text![Alt text](http://static.cnblogs.com/images/logo_small.gif "Optional title")
详细叙述如下:
一个惊叹号 !
接着一个方括号,里面放上图片的替代文字
接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 'title' 文字。
2. 参考式
![Alt text][id]
![Alt text][id]
id 是图片参考的名称,图片参考的定义方式则和链接参考一样:
[id]: http://static.cnblogs.com/images/logo_small.gif "Optional title attribute"
[id]: http://static.cnblogs.com/images/logo_small.gif "Optional title attribute"
Markdown没有办法指定图片的宽高,如果需要可以使用普通img
标签。
自动链接
用尖括号包起来:
http://example.com
address@example.com
反斜杠
Markdown 支持以下符号前面加反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号