Markdown 速查笔记

Markdown 是一种轻量级的标记语言,可用于在纯文本文档中添加格式化元素。Markdown 由 John Gruber 于 2004 年创建,如今已成为世界上最受欢迎的标记语言之一。

Markdown 有以下特点:

  • 专注于文字内容;
  • 纯文本,易读易写,可以方便地纳入版本控制;
  • 语法简单,没有什么学习成本,能轻松在码字的同时做出美观大方的排版。

Markdown 文件是文本文件,通常以 .md 或 .markdown 作为扩展名。

官网:https://www.markdownguide.org/
中文教程:https://markdown.com.cn/

基础语法

标题

在行首添加 1~6 个井号 # 表示一级标题至六级标题
井号与文本中间要含有空格

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

段落

使用空白行进行段落分隔

这是一段文本。

这是另一段文本。

换行

在句尾加两个空格实现段内换行。

这是同段文本的第一句话。  
这是同段文本的第二句话。

斜体

使用一对星号 * 包裹文本

*斜体文本*

粗体

使用一对双星号 ** 包裹文本

**粗体文本**

引用块

在行首添加大于号 >
大于号与文本中间要含有空格

> 引用文本

短代码

使用一对反引号 ` 包裹文本

`短代码文本`

有序列表

在行首添加数字与小数点的组合 1. 2. 3.
组合与文本中间要含有空格

1. 列表元素
2. 列表元素
3. 列表元素

无序列表

在行首添加短横 -
短横与文本中间要含有空格

- 列表元素
- 列表元素
- 列表元素

链接

使用方括号 [] 和圆括号 () 的组合
方括号内填写展示文本
圆括号内填写网址链接

[奕星球](http://estar.zone)

图片

使用感叹号 ! 、方括号 [] 和圆括号 () 的组合
方括号内填写替代文本
圆括号内填写图片路径

![头像](avatar.jpg)

分割线

在新行添加三短横 --- 或三星号 *** 或三下划线 ___

---
***
___

转义

将反斜杠 \ 加在下列特殊字符前可将其正常显示
\ ` * _ {} [] () # + - . ! |

扩展语法

注意:并非所有 Markdown 编辑器都支持扩展语法

删除线

使用一对双波浪线 ~~ 包裹文本

~~删除文本~~

高亮

使用一对双等号 == 包裹文本

==高亮文本==

表格

使用竖分隔符 | 区分表格列
使用换行符区分表格行
短横行可选是否添加,如果添加则需加在第二行
短横行的上方一行是标题单元格,下方多行是数据单元格
Markdown 暂不支持单元格合并

| 列一    | 列二    |
| ------- | ------- |
| AA      | BB      |
| aa      | bb      |

代码块

使用一对三反引号 ``` 或三波浪线 ~~~ 包裹多行文本
三反引号或三波浪线要新起一行

```
这是一段代码
```
~~~
这是一段代码
~~~

推荐编辑器

Typora

官网:https://typora.io
中文官网:https://typoraio.cn
支持平台:Windows / Mac / Linux
付费

VScode + Markdown All in One

官网:https://code.visualstudio.com/
支持平台:Windows
需安装插件 Markdown All in One
免费

MarkText

官网:https://www.marktext.cc
支持平台:Windows / Mac / Linux
免费

在线编辑器

链接:https://markdown.com.cn/editor/
支持平台:网页在线使用
免费

留下评论