Markdown语法速查表

[teachat8]

基本符号

*,-,+ 3个符号效果都一样，这3个符号被称为 Markdown符号
空白行表示另起一个段落
`是表示inline代码，tab是用来标记 代码段，分别对应html的code，pre标签

标题与文字格式

---

标题

生成h1—h6,在文字前面加上 1—6个# 来实现

# 这是 H1 <一级标题>
## 这是 H2 <二级标题>
###### 这是 H6 <六级标题>

换行

单一段落( <p>) 用一个空白行
连续两个空格 会变成一个 <br>
连续3个符号，然后是空行，表示 hr横线

文字格式

粗体和斜体：用星号*或者下划线_

**这是文字粗体格式**
*这是文字斜体格式*
***这是文字粗斜体格式***
~~在文字上添加删除线~~

列表

---

这个是markdown文件的主要表示方式，主题要点化
使用*,+,-加上一个空格来表示
可以支持嵌套
有序列表用 数字+英文点+空格来表示
列表内容很长，不需要手工输入换行符，css控制段落的宽度，会自动的缩放的

无序列表

无序列表使用*、+或-后面加上空格来表示。

* 项目1
* 项目2
* 项目3

有序列表

有序列表使用数字加英文句号加空格表示。

1. 项目1
2. 项目2
3. 项目3
   * 项目1
   * 项目2

其他

---

图片

图片的使用方法基本上和链接类似，只是在中括号前加叹号。

一行表示: ![alt_text](url "可选的title")
引用表示法: ![alt_text][id],预先定义 [id]:url "可选title"
直接使用标签，这样可以指定图片的大小尺寸
注：Markdown不能设置图片大小，如果必须设置则应使用HTML标记
HTML示例：<img src="/assets/images/jian.jpg" alt="替代文本" title="标题文本" width="620" height="520" />
![图片名称](http://gitcafe.com/image.png)

链接

直接写 锚文本
引用 先定义 [ref_name]:url，然后在需要写入url的地方， 这样使用[锚文本][ref_name]，通常的ref_name一般用数字表示，这样显得专业
简写url：用尖括号包裹url
这样生成的url锚文本就是url本身

格式

[链接名称](http://gitcafe.com)

引用

在第一行加上 “>”和一个空格，表示代码引用，还可以嵌套
第一行引用文字
第二行引用文字

水平线

使用三个以上的”*”或”-”来表示。这些星号跟减号之间可以用空格，如果减号没有空格，那它必须在单独的一个段落里，要不它会被识别为标题的
***

代码

行内代码使用反斜杠`表示。
代码段落则是在每行文字前加4个空格或者1个缩进符表示。
`<hello world>`

代码与高亮

嵌入代码块

以3个反引号为开始与结束:

 import this
 print 'something'

反引号键一般在键盘按键1左侧，需要在英文状态下输入。

代码高亮

如果声明代码语言的，会进行代码高亮的处理。

 ruby
 def add(a, b)
 return a + b
 end

如果语言后面多一个:n，则会显示代码的行号。

 ruby:n
 def add(a, b)
 return a + b
 end
 

代码的高亮的具体样式是由CSS控制的，由Pygments生成。你可以访问Pygments Styles查看常见的几种风格。

表格

 First Header | Second Header | Third Header
 ------------ | ------------- | ------------
 Content Cell | Content Cell  | Content Cell
 Content Cell | Content Cell  | Content Cell

脚注

 This is emphatically [^1]
 Something else [^key2].
 EOF

 [^1]: emphatically: 坚决地，着重地，强调地（~ deny 坚决否定）
 [^key2]: key2的注释

特殊符号

用\来转义，表示文本中的markdown符号
可以在文本种直接使用html标签，但是要注意在使用的时候，前后加上空行
文本前后各加一个符号，表示斜体