(I) 区块内容 Block
段落和换行
和LATEX
一样,用一个以上的空行代表分段,而没有空行的换行被忽略,所以允许段内强制 换行
标题
Markdown支援两种标题的语法,Setext和atx形式。
Setext形式是用底线的形式,利用=(最高阶标题)和-(第二阶标题),例如:
This is an H1
=============
This is an H2
-------------
Atx形式则是在行首插入1至6个#,对应到标题1到6阶,例如:
# This is an H1
## This is an H2
###### This is an H6
引言
Markdown使用email形式的区块引言,如果你很熟悉如何在email信件中引言,你就知道怎麼在Markdown文件中建立一个区块引言,那会看起来像是你强迫断行,然后在每行的最前面加上>:
> 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.
或者只在段落第一行加上>:
> 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.
看起来效果像这样:
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.
区块引言可以有阶层(例如:引言内的引言),只要根据层数加上不同数量的>:
This is the first level of quoting.
This is nested blockquote.
Back to the first level.
引言的区块内也可以使用其他的Markdown语法,包括标题、清单、程式码区块等:
This is a header.
- This is the first list item.
- This is the second list item.
Here's some example code:
return shell_exec("echo $input | $markdown_script");
清单
无序清单
使用星号、加号或是减号作為清单标记:
* Red
* Green
* Blue
等同於:
+ Red
+ Green
+ Blue
也等同於:
- Red
- Green
- Blue
有序清单
有序清单则使用数字接著一个英文句点,但是序号数字可以随意,只要是数字即可,例如:
1. Bird
2. McHale
3. Parish
效果等同于:
3. Bird
1. McHale
8. Parish
看起来都是:
- Bird
- McHale
- Parish
源代码
缩排4个空白或是1个tab就可以
分割线
在一行中用三个或以上的星号、减号、下划线来建立一个分隔线,行内不能有其他东西。你也可以在星号中间插入空白。下面每种写法都可以建立分隔线:
*********
__________
(II) 段内元素
强调
Markdown使用星号*
和底线_
作為标记强调字词的符号,被*
或_
包围的字词会被转成斜体,用两个*
或_
包起来的话,则会被转成黑体,例如:
single asterisks
_single underscores_
**double asterisks**
__double underscores__
看起来是这样:
single asterisks
single underscores
double asterisks
double underscores
段内源代码
如果要标记一小段行内源代码,你可以用反引号把它包起来(`),例如:
Use the `printf()` function.
看起来就是: Use the printf() function.
超链接
被链接的文字用[]包起来,在方块括号后面马上接著括号并插入网址连结即可,比如:
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
看起来像:
This is an example inline link.
This link has no title attribute.
图片
与超链接类似,不过在前面多加一个感叹号:
![百度头条](http://tieba.baidu.com/p/3137905063)
转义字符
用\将特殊字符如*, [, > 变成普通字符