1 Markdown简介
百度百科释义:Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(英语:John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
由于Markdown的轻量化、易读易写特性,并且对于图片、图表、数学式都有支持,被网站广泛使用来撰写帮助文档或是用于论坛上发表消息。
2 Markdown特点
通过简介部分相信大家应该对Markdown有了初步了解,综合来看,可以用以下四点来大致概括这一被广泛使用的语言。
- 一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
- 于 2004 由约翰·格鲁伯(英语:John Gruber)创建。
- 编写的文档可导出 HTML 、Word、图像、PDF、Epub 等多种格式。
- 编写的文档后缀为 .md, .markdown。
3 Markdown基本语法
3.1 标题
随着“#”号个数增加,标题级别逐级下降。其中,“#”与文字间存在一个空格。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
3.2 斜体和粗体
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___
显示效果:
- 斜体文本
- 斜体文本
- 粗体文本
- 粗体文本
- 粗斜体文本
- 粗斜体文本
3.3 换行
-
一句话后面敲两个空格。
-
两句话之间加一个空行。
-
语言分行位置输入代码<br/>
。
3.4 分割线
***
*****
----------
显示效果:
3.5 列表
3.5.1 无序列表
利用使用 *,+,- 表示无序列表。
* 无序列表项 一
+ 无序列表项 二
- 无序列表项 三
显示效果:
3.5.2 有序列表
利用数字后加一个英文句点。
1. 有序列表项 一
2. 有序列表项 二
3. 有序列表项 三
显示效果:
- 有序列表项 一
- 有序列表项 二
- 有序列表项 三
3.5.3 定义型列表
由名词和解释组成。一行写定义,接着一行写解释。解释语句写法:紧跟一个缩进(Tab)。
Markdown
一种轻量级标记语言
代码块 2
代码块2的定义说明
显示效果:
Markdown
一种轻量级标记语言
代码块 2
代码块2的定义说明
3.5.4 列表缩进
项目标记后面则一定要接着至少一个空格或制表符。
* Markdown是一种轻量级标记语言,创始人为[约翰·格鲁伯](英语:John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
* 由于Markdown的轻量化、易读易写特性,并且对于图片、图表、数学式都有支持,被网站广泛使用来撰写帮助文档或是用于论坛上发表消息。
显示效果:
- Markdown是一种轻量级标记语言,创始人为[约翰·格鲁伯](英语:John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
- 由于Markdown的轻量化、易读易写特性,并且对于图片、图表、数学式都有支持,被网站广泛使用来撰写帮助文档或是用于论坛上发表消息。
3.5.5 包含段落的列表
每个项目下的段落都必须缩进 4 个空格或是 1 个制表符。
* Markdown是一种轻量级标记语言,创始人为[约翰·格鲁伯](英语:John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
由于Markdown的轻量化、易读易写特性,并且对于图片、图表、数学式都有支持,被网站广泛使用来撰写帮助文档或是用于论坛上发表消息。
显示效果:
- Markdown是一种轻量级标记语言,创始人为[约翰·格鲁伯](英语:John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
由于Markdown的轻量化、易读易写特性,并且对于图片、图表、数学式都有支持,被网站广泛使用来撰写帮助文档或是用于论坛上发表消息。
3.5.6 包含引用的列表
“>”符号前就需要加缩进。
* 一天是什么:
> 睁眼。
> 闭眼。
显示效果:
3.5.7 包含代码区块的引用
将代码块放入<>
。
`<这是一个代码块>`
显示效果:
<这是一个代码块>
4 Markdown进阶
4.1 锚点操作
锚点含义:页内添加超链接,即链接本文档内部的某部分元素,实现当前页面中的跳转。
跳转到[Markdown简介](#index)
显示效果:
跳转到Markdown简介
4.2 插入代码
4.2.1 插入行内式
`abs()` 函数使用方法
显示效果:
abs()
函数使用方法
4.2.2 缩进式多行代码
缩进 4 个空格或是 1 个制表符。
#include <stdio.h>
int main(void)
{
printf("Hello world\n");
}
显示效果:
#include <stdio.h>
int main(void)
{
printf("Hello world\n");
}
4.2.3 用六个`包裹多行代码
在插入代码开始和结尾行分别加三个`符号。
```
#include <stdio.h>
int main(void)
{
printf("Hello world\n");
}
、、、
显示效果:
#include <stdio.h>
int main(void)
{
printf("Hello world\n");
}
、、、
4.2.4 HTML 原始码
代码区内, & 、 < 和 > 会自动转成 HTML 实体。
<div class="footer">
© 2004 Foo Corporation
</div>
<table>
<tr>
<th rowspan="2">销售冠军</th>
<th>星期一</th>
<th>星期二</th>
<th>星期三</th>
</tr>
<tr>
<td>张三</td>
<td>李四</td>
<td>王五</td>
</tr>
</table>
显示效果:
© 2004 Foo Corporation
值班人员 |
星期一 |
星期二 |
星期三 |
李强 |
张明 |
王平 |
4.3 插入链接
[百度](https://www.baidu.com)
或
<https://www.baidu.com>
显示效果:
百度
或
https://www.baidu.com
4.4 插入图片
<div align="center">
<img src="https://img-blog.csdnimg.cn/img_convert/af74d45eef8f36b4194bf25524f608f4.png" width="20%" >
</div>
显示效果:
4.5 插入表格
示例:3行4列表格(含表头)。
| 表头 | 表头 | 表头 | 表头 |
| :----: | :----: | :----: | ------ |
| 单元格 | 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 | 单元格 |
显示效果:
表头 |
表头 |
表头 |
表头 |
单元格 |
单元格 |
单元格 |
单元格 |
单元格 |
单元格 |
单元格 |
单元格 |
4.6 添加脚注
脚注具体内容自动移动到文章末尾。同时脚注后方的链接可以直接跳转回到加注的地方。
使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Leanote[^Le] 编辑器进行书写。
[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
[^3]:开源笔记平台,支持Markdown和笔记直接发为博文
显示效果:
使用 Markdown可以效率的书写文档, 直接转换成 HTML, 你可以使用 Leanote 编辑器进行书写。
4.7 LaTeX 公式
4.7.1 行内公式
正方形面积公式: $S=L^2$。
显示效果:
正方形面积公式:
S
=
L
2
S=L^2
S=L2。
4.7.2 整行公式
更多公式可参考:LaTeX 公式
$$
正方形面积公式:S=L^2
$$
显示效果:
正
方
形
面
积
公
式
:
S
=
L
2
正方形面积公式:S=L^2
正方形面积公式:S=L2
参考文献