Markdown语法帮助

Markdown语法帮助

---

1.标题

2.列表

3.引用

4.粗体与斜体

5.链接与图片

6.代码块

7.分割线与删除线

8.代码块与语法高亮

9.表格

10.Latex 数学公式

11.UML图

---

---

• 1.标题
  在文字写书写不同数量的#可以完成不同的标题，如下：

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

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

  二级标题=======二级标题-------

---

• 2.列表
  无序列表的使用，在符号“-”后加空格使用。
  如下：

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

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

  - 无序列表1
- 无序列表2
  - 无序列表2.1
   - 列表内容
   - 列表内容


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

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

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

  ---

• 3.引用
  引用的格式是使用符号“>”后面书写文字，及可以使用引用。如下：

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

---

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

  **这个是粗体**
*这个是斜体*
***这个是粗体加斜体*

  效果如下：

  这个是粗体
  这个是斜体
  这个是粗体加斜体

---

• 5.链接与图片
  在文中直接加链接，中括号中是需要添加链接的文字，圆括号中是需要添加的链接，如下：

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

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

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

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

<http://example.com/> or
<[e-mail]>

插入互联网上图片，格式如下：


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

---

• 6.代码块
  用TAB键起始的段落，会被认为是代码块，如下：
  
  效果如下：

  
  echo “hello world”;
  

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

  效果如下：

  Use the printf()function

---

• 7.分割线与删除线
  可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，同时需要在分隔线的上面空一行。如下：

  —
  ***
  ___

  删除线的使用，在需要删除的文字前后各使用两个符合“~”，如下:

  \~~Mistaken text.~~
  注：这里\是笔者为显式所加。

---

• 8.代码块与语法高亮
  在需要高亮的代码块的前一行及后一行使用三个反引号“`”，同时第一行反引号后面表面代码块所使用的语言，如下：
  

  ”’ruby
  require ‘redcarpet’
  markdown = Redcarpet.new(“Hello World!”)
  puts markdown.to_html
  ”’
  注：反引号是和波浪线一个键的符号，这里用’代替。

---

• 9.表格
  可以使用冒号来定义表格的对齐方式，
  如下：
  | Tables | Are | Cool |
  | ————- |:————-:| —–:|
  | col 3 is | right-aligned | 1600||col2is|centered|12 |
  | zebra stripes | are neat | $1 |

效果如下：

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

---

• 10.Latex 数学公式
  使用MathJax渲染LaTex 数学公式，详见[math.stackexchange.com]
  行内公式，数学公式为：
  $\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$

块级公式：

$$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$

效果如下：

Γ(n)=(n−1)!∀n∈N

和块级公式：

x=−b±b2−4ac−−−−−−−√2a

更多LaTex语法请参考 这儿。

---

• 11.UML图
  可以渲染序列图：
  

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

效果如下：

或者流程图：

”’flow
st=>start: 开始
e=>end: 结束
op=>operation: 我的操作
cond=>condition: 确认？

st->op->cond
cond(yes)->e
cond(no)->op
”’
注：这里反引号用’代替

效果如下：

• 关于 序列图 语法，参考 这儿
• 关于 流程图 语法，参考 这儿

---

声明：本文系转载，版权归原作者所有。

---