Markdown教程

一、Markdown教程

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

1.Markdown 应用

Markdown 能被使用来撰写电子书，如：Gitbook。
当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如：GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。
我们常用的jupyter亦可以使用Markdown书写

2.编辑器

我使用的编辑器是Win7系统的Markdownpad2。
注意在工具-markdown中将markdown修改成markdown扩展
推荐使用Typora，Markdownpad等主流编辑器

二、Markdown基本用法

1、单个回车，视为空格
2、连续回车，才能分段
3、行尾加两个空格，就可以段内换行
4、注释可使用HTML的注释
5、也可以使用HTML标签

1.Markdown标题

1、使用 = 和 - 标记一级和二级标题
在数量上使用没有限制，语法格式如下：

I have never forgot you.
---
I miss you all the time.
=======

效果如下：

I have never forgot you.

I miss you all the time.

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

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

效果如下：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2.Markdown段落

（1）字体

Markdown可以使用以下几种字体：

*斜体文字*
**粗体文字**
***粗斜体文字***
_斜体文字_
__粗体文字__
___斜粗体文字___

效果如下：
斜体文字
粗体文字
粗斜体文字
斜体文字
粗体文字
粗斜体文字

（2）分隔线

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

---
___
***
- -   -
_          _   _
*               * *

效果如下：

---

---

---

---

---

---

---

（3）删除线

在Typora编辑器中如果段落上的文字要添加删除线，只需要在文字的两端加上两个波浪线 ~~ 即可。传统Markdown暂不支持这种方法。
前端预览是js渲染的，后端输出php处理的，两者的markdown语法有差异。
~~来做删除线被认为是不规范的markdown语法，js渲染那边会去掉。
在Markdownpad2中使用，波浪线不可以预览出删除线效果，需要在两端加上HTML的<del>即可

RUNOOB.COM
GOOGLE.COM
<del>BAIDU.COM<del>

效果如下：
RUNOOB.COM
GOOGLE.COM
BAIDU.COM
东北大学

（4）下划线

下划线可以通过HTML的<u>标签来实现。

<u>i miss you</u>

i miss you

（5）脚注

脚注是对文本的补充说明。
Markdown的脚注格式如下：

[^要注明的文本]

以下实例演示了脚注的用法：

脚注 [^i cannot forget you]
[^i cannot forget you]:i miss you

效果如下：
脚注 [^i cannot forget you]
[^i cannot forget you]:i miss you

Markdown列表

Markdown 支持有序列表和无序列表。列表的上面需要一行空行，同事列表符号和文本之间需要空格

（1）无序列表

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

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

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

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

• 第一项
• 第二项
• 第三项

• 第一项
• 第二项
• 第三项

• 第一项
• 第二项
• 第三项

（2）有序列表

有序列表使用数字并加上 . 号来表示，后面加上一个空格，这一点跟word很相似。如：

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

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

Markdown区块

Markdown 区块引用是在段落开头使用 > 符号 ，然后后面紧跟一个空格符号：

>all the time
>i miss you
>i cannot forget you

all the time
i miss you
i cannot forget you

另外区块是可以嵌套的，一个 > 符号是最外层，两个 > 符号是第一层嵌套，以此类推：

>all the time
>>i miss you
>>>i cannot forget you

all the time

i miss you

i cannot forget you

区块中使用列表

区块中使用列表实例如下：

> 区块中使用列表  
> 1. 第一项  
> 2. 第二项  
> + 第一项   
> + 第二项  
> + 第三项  

区块中使用列表

1. 第一项
2. 第二项

• 第一项
• 第二项
• 第三项

列表中使用区块

如果要在列表项目内放进区块，那么就需要在 > 前添加四个空格的缩进。
区块中使用列表实例如下：

• 从前

  we fall in love

• 现在

  we go our separate ways

  i was so useless that i lost you

  but i never give up

• 未来

  we will have the happiness for ourselves

Markdown代码

（1）片段代码

如果是段落上的一个函数或片段的代码可以用一个反引号把它包起来（`）或者三个反引号，例如：

`i miss you`  
```i am very sad,and words cannot express my sorrow ```  

i miss you
i am very sad,and words cannot express my sorrow

（2）代码块

代码区块使用 4 个空格或者一个制表符（Tab 键）。注意上面需要有一行空行。

[Tab]i was wondering if we could meet again

效果如下：

i was wonderding if we could meet again

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

Markdown链接

Markdown链接语法如下：

1. 直接设置
  [链接名称](链接地址)
[链接名称]（链接地址 "title"）
2. 间接设置 
[链接名称][标记]
[标记]: 链接地址 "链接title"
3. 隐式设置
[链接名称][]
[链接名称]: 链接地址 "链接title"
<链接地址>

例如：

[哔哩哔哩动画](https://www.bilibili.com)
[百度][baidu]
[baidu]:https://www.baidu.com "百度一下，你就知道"
[4399游戏][]
[4399游戏]:https://www.4399.com "4399小游戏"
<https://www.bilibili.com>

效果如下：
哔哩哔哩动画
[百度][baidu]
[baidu]:https://www.baidu.com "百度一下，你就知道"
[4399游戏][]
[4399游戏]:https://www.4399.com "4399小游戏"
https://www.bilibili.com

Markdown图片

Markdown 图片语法格式如下：

1. 直接设置
![名称](图片地址)
![名称](图片地址 "title")
可以打开同一文件夹的图片将图片地址换成相对位置就行
2. 间接设置
![名称][标记]
[标记]:图片地址 "链接title"

例如：

![世界第一初恋](https://p0.ssl.qhimgs1.com/sdr/400__/t01cd0d4d399525cc2e.jpg "世界第一初恋")
![学习][123]
[123]:https://p0.ssl.qhimgs1.com/sdr/400__/t012fd283ddf3cc341e.jpg "好好学习"
![](satumi.png)

效果如下：

![学习][123]
[123]:https://p0.ssl.qhimgs1.com/sdr/400__/t012fd283ddf3cc341e.jpg "好好学习"

Markdown表格

Markdown 制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行。
语法格式如下：

关于冒号（:）
左边：以下内容左对齐
右边：以下内容右对齐
两边：以下内容居中对齐

例如：
|所在职位|工资|年龄|
|:--|----: | :--: |
|法师|2000rmb|54|
|牧师|1800rmb|100|
|坦克|2300rmb|1200|
效果如下：

所在职位	工资	年龄
法师	2000rmb	54
牧师	1800rmb	100
坦克	2300rmb	1200

Markdown高级技巧

（1）支持的HTML元素

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

目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等，
如：使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

使用 Ctrl+Alt+Del 重启电脑

（2）转义

Markdown 使用了很多特殊符号来表示特定的意义，如果需要显示特定的符号则需要使用转义字符，Markdown 使用反斜杠转义特殊字符：

\\   反斜线
\`   反引号
\*   星号
\_   下划线
\{}  花括号
\[]  方括号
\()  小括号
\#   井字号
\+   加号
\-   减号
\.   英文句点
\!   感叹号

效果如下：
\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 小括号
# 井字号
+ 加号
- 减号
. 英文句点
! 感叹号

（3）公式（markdownpad2应该不支持）

当你需要在编辑器中插入数学公式时，可以使用两个美元符 $$ 包裹 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}
${$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}
$$

（4）文档目录（markdownpad2应该不支持）

（5）画流程图、时序图(顺序图)、甘特图等（markdownpad2应该不支持）

综上，我觉得markdownpad2虽然界面看起来很舒服，但是还是功能不够齐全。建议使用typora。

Markdown快捷键

Ctrl + I ： 斜体
Ctrl + B ： 粗体
Ctrl + G ： 图片
Ctrl + Q ： 引用
Ctrl + 1 ： 标题 1
Ctrl + 2 ： 标题 2
Ctrl + 3 ： 标题 3
Ctrl + K ： 代码块
Ctrl + L ： 超链接
Ctrl + T ： 时间戳
Ctrl + U ： 无序列表
Ctrl + R ： 水平标尺
Ctrl + Z ： 撤销
Ctrl + Y ： 重做
F4 ： 启用水平布局
F5 ： 启用实时预览
F6 ： 在浏览器中预览
Ctrl + Shift + O ： 有序列表
代码的前后需空行，代码需要在原来的基础上再缩进。

参考内容：

20分钟教你使用Markdown
菜鸟教程