MarkDown — 简要语法
标题
在 Markdown 中,如果一段文字被定义为标题,只要在这段文字前加 # 号即可。
# 一级标题
## 二级标题
### 三级标题
以此类推,总共六级标题,建议在井号后加一个空格,这是最标准的 Markdown 语法。
引用
如果你需要引用一小段别处的句子,那么就要用引用的格式。
例如这样
只需要在文本前加入 >
这种尖括号(大于号)即可
列表
在 Markdown 下,列表的显示只需要在文字前加上+
、-
或*
即可变为无序列表,有序列表则直接在文字前加1.
、2.
、3.
符号要和文字之间加上一个字符的空格。
分隔线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
***
* * *
_ _ _
__________
表格
例子如下:
| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
这种语法生成的表格如下:
Tables | Are | Cool |
---|---|---|
col 3 is | right-aligned | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
链接
Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。
不管是哪一种,链接文字都是用 [方括号] 来标记。
要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可,例如:
[
链接文字]
(
网址链接)
"
链接文字"
MarkDown
[MarkDown](http://www.markdown.cn/#links "MarkDown语法说明")
强调
Markdown 使用星号 *
和底线_
作为标记强调字词的符号,被*
或_
包围的字词会被转成用 <em>
标签包围,用两个*
或_
包起来的话,则会被转成 <strong>
,用两个~
包起来的话,会被转成<delete>
例如:
*single asterisks*
例:single asterisks
_single asterisks_
例: single asterisks
**double asterisks**
例:double asterisks
__double asterisks__
例:double asterisks
但是如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号。
如果要在文字前后直接插入普通的星号或底线,你可以用反斜线:
*this text is surrounded by literal asterisks*
\*this text is surrounded by literal asterisks\*
如果你的 *
和 _
两边都有空白的话,它们就只会被当成普通的符号
唯一的限制是,你用什么符号开启标签,就要用什么符号结束。
代码框
在 Markdown下实现非常简单,只需要用两个` 把中间的代码包裹起来。图例:
如果要在代码区段内插入反引号,你可以用多个反引号来开启和结束代码区段。
使用 tab
键即可缩进。
图片
Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。
行内式的图片语法看起来像是:
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")
插入链接与插入图片的语法很像,区别在一个!
号
图片为:![](){ImgCap}{/ImgCap}
链接为:[]()