本文简单介绍下 Markdown 的基本语法,让初学者可以快速入门并使用这种标记语言。
标题
标题(h1~h6)可使用相应个数的#来生成,如下面的代码将会生成h3:
### this is a level-3 header ###
或者使用底线形式,利用=(最高阶标题)和-(第二阶标题):
This is an H1 ============= This is an H2 -------------
段落和换行
使用一个或多个 空行 分隔内容段来生成段落 (<p>)
在行末输入2个或以上 空格 再回车来生成换行(<br>)
强调
被1个*或_包围起来的文字将会被<em>标签包围:
*single asterisks* _single underscores_
被2个*或_包围起来的文字将会被<strong>标签包围:
**double asterisks** __double underscores__
注:如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号。
分隔线
在一行内使用3个以上的*-或_来建立 分隔线 (<hr>),行内除此之外不能有其它内容:
* * * *** ***** - - - ---------------------------------------
区块引用
使用>作为段落前缀来标识引用文字段落。这其实是 email 中标记引用文字的标准方式:
> 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. > > Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse > id sem consectetuer libero luctus adipiscing.
列表
使用*+-来表示无序列表<ul>:
* Red * Green * Blue
使用数字紧跟一个 英文句点 .来表示有序列表ol:
1. Bird 2. McHale 3. Parish
代码
使用 反引号 (`)(在键盘上位于1的左边)把文字括起来来表示行内代码,这段文字将会被<code>标签包围:
Use the `printf()` function.
使用4个 空格 或1个 制表符 (Tab)缩进来表示代码区块,它们将被<pre>和<code>标签包裹起来,在代码区块里面的&<和>会自动转成 HTML 实体:
<div class="footer"> © 2004 Foo Corporation </div>
链接
行内式语法:
This is [an example](http://example.com/ "Title") inline link. [This link](http://example.net/) has no title attribute.
参考式语法:
This is [an example][id] reference-style link. [id]: http://example.com/ "Optional Title Here"
注:下面的链接定义,你可以把它放到文章的任意位置。
自动链接:
<http://example.com/>
隐式链接标记:
I get 10 times more traffic from [Google][] than from [Yahoo][] or [MSN][]. [google]: http://google.com/ "Google" [yahoo]: http://search.yahoo.com/ "Yahoo Search" [msn]: http://search.msn.com/ "MSN Search"
图片
图片的语法和链接比较相似,也有 行内式 和 参考式 两种。
行内式语法:
![Alt text](/path/to/img.jpg) ![Alt text](/path/to/img.jpg "Optional title")
参考式语法:
![Alt text][id] [id]: url/to/image "Optional title attribute"
注:到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的<img>标签。
转义字符
可以利用反斜杠来插入一些在语法中有其它意义的符号:
\*literal asterisks\*
Markdown支持的转义字符列表:
\ 反斜线 ` 反引号 * 星号 _ 底线 {} 花括号 [] 方括号 () 括弧 # 井字号 + 加号 - 减号 . 英文句点 ! 惊叹号
其它
书写表格: Markdown 并没有提供表格语法,但你可以像写 HTML 那样使用标签来书写表格,但要注意 HTML 标签内的 Markdown 表达式将不会被解析。
代码高亮: 这不在Markdown支持的范围之内,OSC 的 Markdown 编辑器支持代码高亮,你可以在代码上方使用<!--lang: java-->或lang: java的形式来指定编程语言,这样文章在显示的时候会使用SyntaxHighlighter 自动按照指定的语言进行语法着色。
转自: http://justcoding.iteye.com/blog/1954655
Markdown 的基本语法