推荐md学习网址:http://www.appinn.com/markdown/
Note:不同markdown编辑器对markdown语法的兼容性不一样,可能在不同的编辑器上面使用,会有不一样的效果
可以在markdown中直接使用html一部分标签;
<h1>sdongwan</h1>
<table>
<tr>
<td>Foo</td>
<td>Foo</td>
<td>Foo</td>
<td>Foo</td>
</tr>
</table>
<ol>
<li>sdongwan</li>
<li>fds</li>
<li>fdssfdsf</li>
</ol>
实际效果:
sdongwan
Foo | Foo | Foo | Foo |
- sdongwan
- fds
- fdssfdsf
在html中,为了避免冲突,使用“<” 与”&”符号需要进行转义:“<”用<
来代替,“&”用&
来代替;”&”字符在网址中也要进行转换,转换为&
在md语法中,使用“<”与“&”符号,md会自动进行上述的转换,保证html文档的兼容性;
AT&T//在md中会自动转换成下面
AT&T
---------------------------------
4 < 5//在md中会自动转换成下面
4 < 5
版权符号:
©
实际效果:
©
在md中Enter键换行不太可行,换行时使用html标签<br/>
,或者直接在想插入换行符的地方按入两个以上的空格再回车;
在markdown中标记标题:
- 使用底线的形式进行标记 (底线的个数不限制) ,这时类setext形式
This is an H1
================
This is an H2
-----------------
实际效果:
This is an H1
This is an H2
- 使用#来进行标题标记,使用#一个至六个来对应h1-h6这是类atx形式
//注意#与后面的文字之间要留有空格
# 这是 H1
## 这是 H2
###### 这是 H6
//也可以在文字后面添加#,个数随便,起决定标题阶位的是文字前面的#,在后面添加#完全为了对称美观,注意文字与#号之间留有空格
# 这是 H1#
## 这是 H2 ##
### 这是 H3 ######
实际效果:
这是 H1
这是 H2
这是 H6
这是 H1
这是 H2
这是 H3
区块引用:
在前面加上“>”,”>”与文字之间最好保留一个空格:
> 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.
实际效果如下:
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.
区块引用可以嵌套(引用的引用)
> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
效果如下:
This is the first level of quoting.
This is nested blockquote.
Back to the first level.
引用区域块中也可以包含MarkDown语法,包括标题,列表,代码块
> ## 这是一个标题。
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一些例子代码:
>
> return shell_exec("echo $input | $markdown_script");
效果如下:
这是一个标题。
- 这是第一行列表项。
- 这是第二行列表项。
给出一些例子代码:
return shell_exec("echo $input | $markdown_script");
列表
- 无序列表
无序列表使用加号、减号或星号来做标记
* Red
* Green
* Blue
+ Red
+ Green
+ Blue
- Red
- Green
- Blue
效果如下:
* Red
* Green
* Blue
- Red
- Green
Blue
Red
- Green
Blue
有序列表
有序列表可以直接使用数字加上英文的句号,或直接使用html标签:
1. Bird
2. McHale
3. Parish
<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>
//注意这个写法,效果跟上面是一样的
1. Bird
1. McHale
1. Parish
//注意这个写法,效果跟上面是一样的
3. Bird
1. McHale
8. Parish
效果如下:
1. Bird
2. McHale
3. Parish
- Bird
- McHale
- Parish
- Bird
- McHale
Parish
Bird
- McHale
- Parish
要让列表看起来更漂亮,你可以把内容用固定的缩进整理好:
//自己把内容缩进
* 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.
//自己没把内容进行缩进,但是markdown会自动缩进
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,viverra nec, fringilla in, laoreet vitae, risus.
* onec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
效果如下:
* 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.
- Lorem ipsum dolor sit amet, consectetuer adipiscing elit.Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,viverra nec, fringilla in, laoreet vitae, risus.
- onec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符:
1. This is a list item 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.
2. Suspendisse id sem consectetuer libero luctus adipiscing.
实际效果:
1. This is a list item 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.
避免在行首出现数字-句点-空白,例如
1986. What a great season.
实际效果为:
1. What a great season.
可以看出被md识别为有序列表,跟我们希望的不一样,这时要使用转义:
1986\. What a great season.
实际效果为:
1986. What a great season.
代码区域块
要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,例如:
这是一个普通段落:
这是一个代码区块。
Markdown 会转换成:
<p>这是一个普通段落:</p>
<pre><code>这是一个代码区块。
</code></pre>
实际效果为:
这是一个普通段落:
这是一个代码区块。
Note:一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。
分割线:
可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
* * *
***
*****
- - -
---------------------------------------
实际效果为:
链接:
链接文字都是用 [方括号] 来标记。要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可;
- 行内式链接
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.
- 参考式链接
参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记:接着,在文件的任意处,你可以把这个标记的链接内容定义出来:
This is [an example][id] reference-style link.
[id]: http://example.com/ "Optional Title Here"
实际效果:
This is an example reference-style link.
- 隐式链接
隐式链接标记功能让你可以省略指定链接标记,这种情形下,链接标记会视为等同于链接文字,要用隐式链接标记只要在链接文字后面加上一个空的方括号
[Google][]
[Google]: http://google.com/
实际效果:
Google
强调
Markdown 使用星号()和底线(_)作为标记强调字词的符号,被 或 _ 包围的字词会被转成用<em>
标签包围,用两个 * 或 _ 包起来的话,则会被转成 <strong>
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
实际效果:
single asterisks
single underscores
double asterisks
double underscores
强调也可以直接插在文字中间:
un*frigging*believable
实际效果:
un*frigging*believable
(这里是csdn的markdown编辑器不支持的原因,所以显示有点奇怪)
note:如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号,两边不能留有空白
如果要在文字前后直接插入普通的星号或底线,你可以用反斜线:
\*this text is surrounded by literal asterisks\*
实际效果:
*this text is surrounded by literal asterisks*
代码
如果要标记一小段行内代码,你可以用反引号把它包起来(`)
Use the `printf()` function.
实际效果:
Use the printf()
function.
如果要在代码区段内插入反引号,你可以用多个反引号来开启和结束代码区段:
``There is a literal backtick (`) here.``
实际效果:
There is a literal backtick (`) here.
插入图片:
- 行内式
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")
- 参考式
![Alt text][id]
[id]: url/to/image "Optional title attribute"
也可以使用标签,这个标签可以指定宽高
自动转换成链接:
<http://example.com/>
实际效果为:
使用反斜杠来引用原字符
\*sdongwan\*
实际效果为:
*sdongwan*
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号