Markdown 语法速查表
基本符号
*,-,+ 3个符号效果都一样,这3个符号被称为 Markdown符号
空白行表示另起一个段落
是表示inline代码,tab是用来标记 代码段,分别对应html的code,pre标签
标题与文字格式
标题
生成h1—h6,在文字前面加上 1—6个# 来实现
# 这是 H1 <一级标题>## 这是 H2 <二级标题>###### 这是 H6 <六级标题>
换行
单一段落(
) 用一个空白行连续两个空格 会变成一个
连续3个符号,然后是空行,表示 hr横线
文字格式
粗体和斜体:用星号*或者下划线_
**这是文字粗体格式***这是文字斜体格式****这是文字粗斜体格式***~~在文字上添加删除线~~
列表
这个是markdown文件的主要表示方式,主题要点化
使用*,+,-加上一个空格来表示
可以支持嵌套
有序列表用 数字+英文点+空格来表示
列表内容很长,不需要手工输入换行符,css控制段落的宽度,会自动的缩放的
无序列表
无序列表使用*、+或-后面加上空格来表示。
* 项目1* 项目2* 项目3
有序列表
有序列表使用数字加英文句号加空格表示。
1. 项目12. 项目23. 项目3 * 项目1 * 项目2
其它
图片
图片的使用方法基本上和链接类似,只是在中括号前加叹号。
一行表示: ![alt_text](url "可选的title")
引用表示法: ![alt_text][id],预先定义 [id]:url "可选title"
直接使用标签,这样可以指定图片的大小尺寸
<strong>注:Markdown不能设置图片大小,如果必须设置则应使用HTML标记</strong>
HTML示例:<img />
![图片名称](http://gitcafe.com/image.png)
链接
直接写 锚文本
引用 先定义 [ref_name]:url,然后在需要写入url的地方, 这样使用[锚文本][ref_name],通常的ref_name一般用数字表示,这样显得专业
简写url:用尖括号包裹url
这样生成的url锚文本就是url本身
格式
[链接名称](http://gitcafe.com)
引用
在第一行加上 “>”和一个空格,表示代码引用,还可以嵌套
第一行引用文字
第二行引用文字
水平线
使用三个以上的”*”或”-”来表示。这些星号跟减号之间可以用空格,如果减号没有空格,那它必须在单独的一个段落里,要不它会被识别为标题的
***
代码
行内代码使用反斜杠
表示。
代码段落则是在每行文字前加4个空格或者1个缩进符表示。
代码与高亮
嵌入代码块
以3个反引号为开始与结束:
import thisprint 'something'
反引号键一般在键盘按键1左侧,需要在英文状态下输入。
代码高亮
如果声明代码语言的,会进行代码高亮的处理。
rubydef add(a, b)return a + bend
如果语言后面多一个:n,则会显示代码的行号。
ruby:ndef add(a, b)return a + bend
代码的高亮的具体样式是由CSS控制的,由Pygments生成。你可以访问Pygments Styles查看常见的几种风格。
表格
First Header | Second Header | Third Header———— | ————- | ————Content Cell | Content Cell | Content CellContent Cell | Content Cell | Content Cell
脚注
This is emphatically [^1]Something else [^key2].EOF[^1]: emphatically: 坚决地,着重地,强调地(~ deny 坚决否定)[^key2]: key2的注释
特殊符号
用\来转义,表示文本中的markdown符号
可以在文本种直接使用html标签,但是要注意在使用的时候,前后加上空行
文本前后各加一个符号,表示斜体