Markdown使用教程

1 介绍

LOGO	简介
	1. Markdown 是一种轻量级标记语言，允许使用易读易写的纯文本格式编写文档。2. Markdown 语言在 2004 由约翰·格鲁伯（英语：John Gruber）创建。3. Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。4. Markdown 编写的文档后缀为 .md, .markdown。

2 标题

1、使用 = 和 - 标记一级和二级标题
2、使用 # 号表示 1-6 级标题，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推

3 段落

3.1 换行

1、在段落末尾加两个空格换行
2、在段落后面回车来换行

3.2 字体

1、斜体

*斜体文本*
_斜体文本_

2、粗体

**粗体文本**
__粗体文本__

3、斜粗体

***粗斜体文本***
___粗斜体文本___

3.3 分割线

在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西，也可以在星号或是减号中间插入空格。

***
*****
---
-----
___
_____
* * *

3.4 删除线

在文字的两端加上两个波浪线 ~~

~~删除文字~~

3.5 下划线

下划线通过 HTML 的<u | /u>标签来实现

<u>带下划线文本</u>

3.6 脚注

脚注是对文本的补充说明

[^要注明的文本]

4 列表

1、无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记

* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项

- 第一项
- 第二项
- 第三项  

2、有序列表使用数字并加上 . 号来表示

1. 第一项
2. 第二项
3. 第三项

3、列表嵌套
列表嵌套只需在子列表中的选项前添加四个空格或者一个 TAB

1. 第一项：
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项：
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第二个元素

5 区块

1、区块引用

在段落开头使用 > 符号和一个空格符号

> 区块引用

2、区块嵌套

一个 > 符号是最外层，两个 > 符号是第一层嵌套，以此类推退

> 最外层
> > 第一层嵌套
> > > 第二层嵌套

3、区块可以与列表相互嵌套

6 代码

1、插入代码

段落上的一个函数或片段的代码可以用反引号( ` )把它包起来

`function`

2、代码区块

• 代码区块使用 4 个空格或者一个制表符（Tab 键）

  tab print(“Hello World!”)

• 用 ```包裹一段代码，并可以指定一种语言（也可以不指定）

    ```python
  
    print("Hello World!")
  
    ```
  

7 链接

1、一般链接

[链接名称](链接地址)

2、直接链接

<链接地址>

3、高级链接

链接也可以用变量来代替，并在文档末尾附带变量地址：
链接用 1 作为网址变量 [Google][1]
然后在文档的结尾为变量赋值（网址）
[1]: http://www.google.com/

8 图片

1、感叹号！[alt 文本属性]（图片地址 “可选title属性文字”）

![alt 属性文本](图片地址 "可选标题")

2、对图片网址使用变量

链接用 1 作为网址变量 [Google][1].
然后在文档的结尾位变量赋值（网址）
[1]: http://www.google.com/google-logo.jpg

3、对图片指定高度和宽度

<img src="图片地址" width="50%">

9 表格

1、制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

2、设置对齐方式

-: 设置内容和标题栏 居右对齐
:- 设置内容和标题栏 居左对齐
:-: 设置内容和标题栏 居中对齐

10 其他

1、支持的HTML元素

不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。

目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等 

2、转义

使用反斜杠转义特殊字符

\*\* 正常显示星号 \*\*

3、公式

使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式，提交后，问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。

$$
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix} 
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$

$${\mathbf{V}}_1\times {\mathbf{V}}_2=\left|\begin{array}{ccc}\mathbf{i}& \mathbf{j}& \mathbf{k}\\ \frac{\partial X}{\partial u}& \frac{\partial Y}{\partial u}& 0\\ \frac{\partial X}{\partial v}& \frac{\partial Y}{\partial v}& 0\end{array}\right|$$