不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown;只要直接加标签就可以了。
要制约的只有一些 HTML 区块元素――比如 div、table、pre、p等标签,必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。
Markdown 支持两种标题的语法,Setext 和 atx 形式。Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题,注意不是下划线)任何数量的等号和减号都会产生效果;Atx 形式在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶。
Setext形式:
Atx形式:
一共六级标题,建议在#后面加个空格
下面的格式都需要注意文本和符号之间的空格:
- 无序
- 无序
- 无序
- 无序
- 有序
- 有序
- 有序
如果列表项之间加入了空行,则所有的列表项被当成一个单独的段落进行处理。
当然列表项中也可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符:
-
This is a list item with three paragraphs.
This is the second para, and is also a quote.
This is the third paragraph.
-
Suspendisese id sem.
注意列表项中的区块代码需要比列表项多缩进一次。
这是引用
引用可以嵌套,亦可以使用其他Markdown语法。Markdown 也允许你偷懒只在整个段落的第一行最前面加上>。
图片为![](),链接为[](),区别只在于一个叹号。链接的圆括号中也可以使用相对路径。例如: 百度(这个超链接带有title属性)。

参考式链接可以放在文件中任何一个地方,可以放在链接出现的段落后面,也可以放在文件最后面,就像注解一样:
I get 10 times more traffic from [google][1] than from [yahoo][2] or [msn][3].
注意连接名称不但可以用1 2 3,字母数字和空格都可以用,但不区分大小写。 [1]: http://google.com/ "google(this is a title)" [2]: http://search.yahoo.com/ [3]: http://search.msn.com/
使用星号和下划线来标记需要强调的区段。两个*包含就是粗体,一个*包含就是斜体,例如:
粗体 斜体
Some of these words are emphasized also.
Or, if you prefer, use two underscores instead.
如果你的*和_两边都有空白的话,它们就只会被当成普通的符号。
如果要在文字前后直接插入普通的星号或者下划线,可以在前面加上反斜线。
后续再整
一般的代码文字中使用反引号`来标记代码区段,例如:
using namespace std。
块代码,每行前面都加4个空格或一个Tab
#include<iostream.h>
using namespace std;
int main(int argc, char * argv[]){
}
你可以在一行中用三个以上的星号*、减号-、下划线_来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
***
* * *
- - -
___
一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行。
当然也可以强制插入换行符br,例如本段开始的地方。
Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。 行内式的图片语法看起来像是:


参考式的图片语法则长得像这样:
![Alt text][id]
图片参考的定义方式则和连结参考一样:
[id]: url/to/image "Optional title attribute"
到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 <img>标签。
对于网址和电子邮箱地址,可以直接用<>括起来,Markdown就会自动把它转成链接。例如:
<http://example.com/>
Markdown会将其转成:
<a href="http://example.com/">http://example.com/</a>
邮址的自动链接也很类似,只是Markdown会先做一个编码转换的过程,把文字字符转成16进位码的HTML实体,这样的格式可以避免直接传送邮箱的明文,在一定程度上防止垃圾邮件的接收。
Markdown支持在以下这些符号前面加上反斜杠来将其变成普通的符号:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
