蓝客之星

Markdown语法帮助

Markdown是一种轻量级的标记语言 ,目前也被越来越多的写作爱好者、撰稿者广泛使用。这里简单分享一些Markdown的常用语法,最后附上简体中文完整版链接

标题

在文字写书写不同数量的#可以完成不同的标题,如下:

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

等号及减号也可以进行标题的书写,不过只能书写二级标题,并且需要写在文字的下面,减号及等号的数量不会影响标题的基数,如下:

1
2
3
4
5
二级标题
=========
二级标题
---------

列表

序列表的使用,在符号“-”后加空格使用。如下:

1
2
3
- 无序列表1
- 无序列表2
- 无序列表3

如果要控制列表的层级,则需要在符号“-”前使用空格。如下:

1
2
3
- 无序列表1
- 无序列表2
- 无序列表2.1

有序列表的使用,在数字及符号“.”后加空格几个,如下:

1
2
3
1. 有序列表1
2. 有序列表2
3. 有序列表3

有序列表如果要区分层级,也可以在数字前加空格。

引用

引用的格式是使用符号“>”后面书写文字,及可以使用引用。如下:

1
2
3
>这个是引用
> 是不是和电子邮件中的
> 引用格式很像

粗体与斜体

粗体的使用是在需要加粗的文字前后各加两个“*”,而斜体的使用则是在需要斜体的文字前后各加一个“*”,如果要使用粗体和斜体,那么就是在需要操作的文字前后各加三个“*”。如下:

1
2
3
**这个是粗体**
*这个是斜体*
***这个是粗体加斜体***

链接与图片

在文中直接加链接,中括号中是需要添加链接的文字,圆括号中是需要添加的链接,如下:

1
[link text](http://example.com/ "optional title")

在引用中加链接,第一个中括号添加需要添加的文字,第二个中括号中是引用链接的id,之后在引用中,使用id加链接:如下:

1
2
[link text][id]
[id]: http://example.com/ "optional title here"

在文中直接引用链接,直接使用尖括号,把链接加入到尖括号中就可以实现,如下:

1
<http://example.com/> or <address@example.com>

插入互联网上图片,格式如下:

1
2
3
![这里写图片描述](http://img3.douban.com/mpic/s1108264.jpg)
![这里写图片描述][jane-eyre-douban]
[jane-eyre-douban]: http://img3.douban.com/mpic/s1108264.jpg

代码块

用TAB键起始的段落,会被认为是代码块,如下:

1
2
3
<php>
echo “hello world";
</php>

如果在一个行内需要引用代码,只要用反引号`引起来就好,如下:

1
`Use the `printf()` function.`

分割线与删除线

可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,同时需要在分隔线的上面空一行。如下:

1
2
---
****

删除线的使用,在需要删除的文字前后各使用两个符合“~”,如下
~~Mistaken text.~~

代码块与语法高亮

在需要高亮的代码块的前一行及后一行使用三个反引号“`”,同时第一行反引号后面表面代码块所使用的语言,如下:

1
2
3
4
ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html

表格

可以使用冒号来定义表格的对齐方式,如下:

1
2
3
4
5
| Tables | Are | Cool |
| ------------- |:------:|: -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |

LaTex数学公式

使用MathJax渲染LaTex 数学公式,行内公式:
$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$

块级公式:
$$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$

UML 图

可以渲染序列图:

1
2
3
张三->李四: 嘿,小四儿, 写博客了没?
Note right of 李四: 李四愣了一下,说:
李四-->张三: 忙得吐血,哪有时间写。

或者流程图:

1
2
3
4
5
6
7
8
st=>start: 开始
e=>end: 结束
op=>operation: 我的操作
cond=>condition: 确认?
st->op->cond
cond(yes)->e
cond(no)->op

Markdown语法说明简体中文完整版: http://wowubuntu.com/markdown/index.html


好咖啡要和朋友一起品尝,好机会也要和朋友一起分享.