5 分钟学会 Markdown

Markdown 和 Json 一样，超级简单，却超级好用

markdown

Markdown 就是一种轻量级的标记语言（Lightweight Markup Language），用人话说就是，普通的文本加上简单的排版或格式化语法（特殊标记），和 HTML，RTF 类似，只是 Markdown 的语法非常简单。Markdown 编写工具很多，在线的也有，很多编程开发工具都支持。需要知道，Markdown 语法没有标准，取决于 Markdown 渲染引擎，各个系统略微有差异。VS Code 和 IntelliJ 都支持 Markdown，喜欢可视化编辑器的话推荐 Typora 。Markdown 文本需要通过转换器变成 HTML 便可以在浏览器里显示，这就是支持 Markdown 的静态博客生成器和 CMS 的原理。

Markdown 语法

标题 Headers

用 # 来表示标题：

# 标题 1 大小不同的标题

## 标题 2 Heading 2

### 标题 3 Heading 3

#### 标题 4 Heading 4

##### 标题 5 Heading 5

###### 标题 6 Heading

💬 效果就不演示了

字体 Emphasis

黑体字 strong：用**或者__来表记黑体
```
这是个**黑体字 strong**
```
斜体字 italic：用 * 或者 _ 来表示斜体
```
这是个*斜体字 italic*
```
删除线 strikethrought： ~~
```
~~加一条删除线 strikethrought~~
```

效果

黑体字 strong
_斜体字 italic_
~~加一条删除线 strikethrought~~

引用块 blockquotes

> 道德经（一级引用）
>
> > 道可，道非，常道（二级引用）

效果

道德经（一级引用）
道可，道非，常道（二级引用）

无序列表 unordered list

*, +, - 都可以表示无序列表：

-   美国
-   俄罗斯
-   英国
-   法国
-   中国
    -   北京
    -   上海
    -   广州

效果

美国
俄罗斯
英国
法国
中国
- 北京
- 上海
- 广州

有序列表 ordered list

1. 个
2. 十
3. 百
4. 千
5. 万
    1. 十万
    2. 百万
    3. 千万
6. 亿

效果

个
十
百
千
万
1. 十万
2. 百万
3. 千万
亿

链接 link

[点击就去 Google](https://www.google.com)

效果点击就去 Google

图片 image

![Singapore](http://www.rw-designer.com/icon-image/924-48x48x32.png)

效果

脚注

页内链接

你可以使用 Markdown[^1]写文档；Kubernetes[^k]非常 NB，你确定不想玩玩嘛
[^1]: Markdown 一种简易的纯文本标记语言
[^k]: 云上的操作系统

效果用 Markdown¹写文档；Kubernetes²非常 NB，你确定不想玩玩嘛

表格 table

略微复杂点，｜ 控制分列，- 控制分行，: 控制对齐方式，左右或居中。

| 职工号 | 姓名 | 年龄 |
| :----: | :--- | :--: |
|   1    | 张三 |  20  |
|   2    | 李四 |  30  |
|   3    | 王二 |  40  |

效果

职工号	姓名	年龄
1	张三	20
2	李四	30
3	王二	40

表格支持还是比较不方便的，可采用在线表格转换工具：tableconvert

转义

markdown 支持在特殊字符前面插入 \，插入之后，将不再解析这些字符，而是原样输出。

这个不是\# 标题
这个不是\*\*黑体字\*\*

效果

这个不是# 标题
这个不是**黑体字**

分割线

---
+++
---

效果

扩展

虽然不是 markdown 语法，但非常有用的功能，静态 blog 或 CMS 基本通过第三方插件来支持，

代码块

```后面接语言种类 - txt，xml，html，markdown，c，c++，java，python，bash，等等。

```c
# include <stdio.h>
void main(){
printf("Hello world!\n");
}
```

效果

# include <stdio.h>
void main(){
	printf("Hello world!\n");
}

还可以有插件支持数学公式。

html

实在不行，可以直接上 html，例如 markdown 里不支持下划线：

<u>下划线</u>

效果下划线

也不支持字体颜色：

<span style="color:green">绿色字体</span>

效果绿色字体

画图

Typora 支持简单的 Markdown 画图，但至今我还没有看到比较好的。

在线练习

操练一把

工具

VS Code + markdown 让 VS Code 支持 markdown，目前在用
Typora markdown 编辑神器，把 markdown 编辑态和展示态融为一体，所写即所见
hugo 静态网站生成器，支持 markdown 来编写 blog，目前在用
vuepress 静态网站生成器，支持 markdown 来编写软件文档，目前在用（新版 Vuepress Next 和 VitePress 开发中）
静态网站资源
- Site Generators
- Headless CMS
tableconvert 表格转换工具
markmap-lib markdown 转 mindmap
mdnice 在线 markdown 编辑，可以选择主题，直接对接微信公众号等

Markdown 一种简易的纯文本标记语言 ↩︎
云上的操作系统 ↩︎