Markdown实用教程

• 2020 年 12 月 5 日
• 筆記
• Markdown

Markdown 是用来编写结构化文档的一种纯文本格式，它使我们在双手不离开键盘的情况下，可以对文本进行一定程度的格式排版。markdown语法是通用的，很多写作平台都是支持markdown的，比如简书，这就意味着做自媒体的你写一次文章，就能很快同步到各大平台，而不需要要考虑不同写作平台之间排版的兼容性，从而兼顾各大平台的流量，让你能专注于写作。

优点

• 简单易学；
• 支持的平台都能通用，省去排版的烦恼；

缺点

• 需要记一些语法，不过这比记26个英文单词要简单多了，五分钟学会；
• 有些平台是不支持markdown的，比如知乎，这么大个平台，不支持markdown；

工具 typora

Typora 是一款支持实时预览的 Markdown 文本编辑器。它有 OS X、Windows、Linux 三个平台的版本，并且由于仍在测试中，是完全免费的。

下载地址：//typora.io/

markdown语法

这里列出一些常用的markdown语法，学会这些，99%的书写排版工作，我相信都能应对了。

1. 标题

在想要设置为标题的文字前面加#来表示，并且用空格将#和标题分隔开。一个#是一级标题，二个#是二级标题，以此类推。支持六级标题。

示例：

# 我是一级标题
## 我是二级标题
### 我是三级标题

效果如下：

我是一级标题

我是二级标题

我是三级标题

2. 字体

平时用word写作的时候，我们需要将关键字黑体加粗，或者斜体标出，为了让读者更能清晰看到我们想表达的东西。

• 加粗

要加粗的文字左右分别用两个*号包起来

• 斜体

要倾斜的文字左右分别用一个*号包起来

• 斜体加粗

要倾斜和加粗的文字左右分别用三个*号包起来

• 删除线

要加删除线的文字左右分别用两个~~号包起来

示例：

**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~

效果如下：

这是加粗的文字

这是倾斜的文字

这是斜体加粗的文字

这是加删除线的文字

3. 引用

在写作时候，有时候为了提升文章的档次和逼格，我们可能会引用别人的东西，对于引用的东西，我们最好用引用标识出来，以免产生误会。引用语法是>，在需要引用的前面加>标识即可。

示例：

>这是引用杜甫的诗《登高》：万里悲秋常作客，百年多病独登台。

效果：

这是引用杜甫的诗《登高》：万里悲秋常作客，百年多病独登台。

4. 分割线

有时候想人为将文章分为几部分，这时候可以用分割线：三个或者三个以上的 – 或者 * 都可以，我通常用3个，省手指。

示例：

---
----
***
*****

效果如下：
可以看到，显示效果是一样的。

5. 图片

你需要首先让这张图片可以在互联网刚开访问，才能在这里使用。语法

![该位置可写可不写](图片地址)

比如这张图片是可以访问的：//qiniu.ikeguang.com/ikeguang.com/image/bi.jpg 你复制地址到浏览器地址栏是可以直接访问的。

示例：

![装逼真讨厌](//qiniu.ikeguang.com/ikeguang.com/image/bi.jpg)

效果：

6. 超链接

有时候我们想点击几个文字，就能跳到一个地址，而不是一长串地址，因为有的地址很长，很难看。

• //www.ikeguang.com/?p=220

• 安装Python教程

上面两个地址，显然第二个可读性更好。

语法：

[要显示的文字](网址)

示例：

[安装Python教程](//www.ikeguang.com/?p=220)
[中国大学排名](//www.ikeguang.com/?p=1409)

效果：

安装Python教程

中国大学排名

7. 列表

列表包括无序列表和有序列表。

无序列表

在要做列表的前面用-+*任意一种标识，并且用空格隔开。

语法：

- 列表内容
+ 列表内容
* 列表内容

效果如下：

• 列表内容

• 列表内容

• 列表内容

有序列表

用数字加点，并且用空格隔开：

语法：

1. 我是有序列表；
1. 我是有序列表；
1. 我是有序列表；

1. 我是有序列表；
2. 我是有序列表；
3. 我是有序列表；

列表嵌套

有时候可能分的层次很细，这时候就需要嵌套列表。

示例：

- 湖北
【两个空格】- 黄冈
【两个空格】- 十堰
 - 。。。
- 湖南
 【两个空格】- 长沙
 【两个空格】- 。。。
- 。。。

效果:

• 湖北
  • 黄冈
  • 十堰
  • 。。。
• 湖南
  • 长沙
  • 。。。
• 。。。

8. 表格

插入普通表格需要构建如下的格式：

示例：

序号 | 姓名 | 年龄
---|---|---
1 | 柯广| 25 |
2|柯小广|18

效果：

默认情况下是左对齐的，下面介绍左对齐，右对齐，居中对齐，添加:符号即可。

左对齐

示例：

序号 | 姓名 | 年龄
:---|:---|:---
1 | 柯广| 25 |
2|柯小广|18

效果：

右对齐

示例：

序号 | 姓名 | 年龄
:---|:---|:---
1 | 柯广| 25 |
2|柯小广|18

效果：

居中对齐

示例：

序号 | 姓名 | 年龄
:---:|:---:|:---:
1 | 柯广| 25 |
2|柯小广|18

效果：

9. 代码

代码块用三个点`包起来，词语用单个抱起来

代码块：

where there is a will,there is a way

单个词语：

有人喜欢装`13`，不说好的，非要说`Good`。

效果：
有人喜欢装13，不说好的，非要说Good。

10. 流程图

流程图的语法大体分为两部分：

• 流程图元素定义部分；
• 连接流程图元素部分，该部分用来指明流程图的执行走向。

flow
st=>start: Start
op=>operation: Your Operation
cond=>condition: Yes or No?
e=>end
st->op->cond
cond(yes)->e
cond(no)->op

效果：