markdown简明语法

Markdown是一种极简的『标记语言』,将文本转为HTML,通常为我大码农所用。其不追求大而全,简洁至上,正所谓不求最贵,只求最好!

本文介绍Markdown基本语法,内容很少,一行语法一行示例,学会后可轻松写出高大上的文档,再也不需要各种编辑器去调文章格式。另外,网上有各平台下的Markdown工具可用,也有在线的,我直接使用sublime搞定,Markdown本来就是为了追求简洁,弄个工具岂不多此一举。

强调

星号与下划线都可以,单是斜体,双是粗体,符号可跨行,符号可加空格
**一个人来到田纳西**

__毫无疑问__
*我做的馅饼
是全天下*
_最好吃的_

一个人来到田纳西

毫无疑问
我做的馅饼
是全天下

最好吃的

分割线

三个或更多-_*,必须单独一行,可含空格
---

引用

翻译成html就是<blockquote></blockquote>,符号后的空格可不要
> 引用

引用

内层符号前的空格必须要    
> 引用
     >> 引用中的引用

引用

引用中的引用

标题:setext方式

三个或更多
大标题
===
小标题
---

大标题

小标题

标题:Atx方式

# 一级标题
## 二级标题
### 三级标题
#### 四级标题

一级标题

二级标题

三级标题

四级标题

无序列表

符号之后的空格不能少,-+*效果一样,但不能混合使用,因混合是嵌套列表,内容可超长
- 无序列表
- 无序列表
- 无序列表
- 无序列表:我很长。我也很长!那比一比啊?比就比!我有这么长,你有我长吗?我有这么这么长!好吧,你赢了!
  • 无序列表
  • 无序列表
  • 无序列表
  • 无序列表:我很长。我也很长!那比一比啊?比就比!我有这么长,你有我长吗?我有这么这么长!好吧,你赢了!
符号之后的空格不能少,-+*效果一样,但不能混合使用,因混合是嵌套列表
+ 无序列表
+ 无序列表
+ 无序列表
  • 无序列表
  • 无序列表
  • 无序列表
符号之后的空格不能少,-+*效果一样,但不能混合使用,因混合是嵌套列表
* 无序列表
* 无序列表
* 无序列表
  • 无序列表
  • 无序列表
  • 无序列表

有序列表

数字不能省略但可无序,点号之后的空格不能少
1. 有序列表
2. 有序列表
3. 有序列表
8. 有序列表
  1. 有序列表
  2. 有序列表
  3. 有序列表
  4. 有序列表

嵌套列表

-+*可循环使用,但符号之后的空格不能少,符号之前的空格也不能少
- 嵌套列表
 + 嵌套列表
 + 嵌套列表
  - 嵌套列表
   * 嵌套列表
- 嵌套列表
  • 嵌套列表
    • 嵌套列表
    • 嵌套列表
    • 嵌套列表
      • 嵌套列表
  • 嵌套列表

文字超链:Inline方式

Tooltips可省略
[雨夜](http://yuye.work "雨夜的博客")

雨夜

图片链接

多个感叹号,Tooltips可省略,要设置大小只能借助HTML标记
![GitHub Mark](http://github.global.ssl.fastly.net/images/modules/logos_page/GitHub-Mark.png "GitHub Mark")
GitHub Mark
GitHub

索引超链:Reference方式

索引,1 2可以是任意字符
[雨夜][1]

![GitHub Octocat][2]

[1]:http://yuye.work
[2]:http://github.global.ssl.fastly.net/images/modules/logos_page/Octocat.png

雨夜

GitHub Octocat

自动链接

尖括号
<http://ibruce.info>

<bu.ru@qq.com>

http://yuye.work

31926990@qq.com

代码:行内代码

`print('hello,word!')`

print('hello,word!')

代码:段落代码

1
2
3
4
def run():
for i in range(10):
print('hello,word!')
run()
1
2
3
4
def run():
for i in range(10):
print('hello,word!')
run()

注释

用html的注释,这样就不显示了,只能从源码查看
<!-- 注释 -->

这里是注释>>>()

表格

1.将第一个<table>变成<table class="table table-bordered table-striped table-condensed">。

  • 它们都会给表格带上某种样式,如果没有的话,比较不好看:
  • 以下三个可以进行不同的组合,如果是很长的表格,建议只用后两个。
    • table-bordered:带圆角边框和竖线
    • table-striped:奇偶行颜色不同
    • table-condensed:压缩行距

2.另外,如果需要表头跟内容不一样,可以将<td>表头内容</td>换成<th>表头内容</th>
3.如果表格内文需要换行,可以在要换行的内容后加入<br>,后面的内容就会跑到下一行。
4.如果内文中有代码,需要特别显示,可使用:<code>代码</code>
5.如果表格中有需要设为斜体的内容,可使用:<I>要设为斜体的内容</I>
6.如果有跨行或者跨列的单元格,可用<th colspan="跨列数">内容</th>
7.跨行则是用rowspan="跨行数"
8.如果要调整某一列的宽度,可使用:<th width="宽度值或百分比">表头内容</th>

如果要调整整个表格的宽度,可以参考berlinix的这篇文章:http://www.ituring.com.cn/article/details/8367

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<table class="table table-bordered table-striped table-condensed">
<tr>
<td>时间</td>
<td>地点</td>
<td>人物</td>
</tr>
<tr>
<td>3月5日</td>
<td>北京</td>
<td>姚明</td>
</tr>
<tr>
<td>3月7日</td>
<td>上海</td>
<td>韩寒</td>
</tr>
</table>
















时间 地点 人物
3月5日 北京 姚明
3月7日 上海 韩寒

转义字符

Markdown中的转义字符为\,转义的有:
\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{\} 大括号
\[\] 中括号
\(\) 小括号
\# 井号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号

其他

文本中可直接用html标签,但是要前后加上空行。