Python自动化实践

*** Python自动化实践 ***
1、为什么要写代码实现接口自动化

大家知道很多接口测试工具可以实现对接口的测试，如postman、jmeter、fiddler等等，而且使用方便，那么为什么还要写代码实现接口自动化呢？工具虽然方便，但也不足之处：

测试数据不可控制

接口测试本质是对数据的测试，调用接口，输入一些数据，随后，接口返回一些数据。验证接口返回数据的正确性。在用工具运行测试用例之前不得不手动向数据库中插入测试数据。这样我们的接口测试是不是就没有那么“自动化了”。

无法测试加密接口

这是接口测试工具的一大硬伤，如我们前面开发的接口用工具测试完全没有问题，但遇到需要对接口参 数进行加密/解密的接口，例如 md5、base64、AES 等常见加密方式。本书第十一章会对加密接口进行介绍。 又或者接口的参数需要使用时间戳，也是工具很难模拟的。

扩展能力不足

当我们在享受工具所带来的便利的同时，往往也会受制于工具所带来的局限。例如，我想将测试结果生 成 HMTL 格式测试报告，我想将测试报告发送到指定邮箱。我想对接口测试做定时任务。我想对接口测试做持续集成。这些需求都是工具难以实现的。

2、接口自动化测试设计

接口测试调用过程可以用下图概括，增加了测试数据库

一般的 接口工具 测试过程：

1、接口工具调用被测系统的接口（传参 username=“zhangsan”）。

2、系统接口根据传参（username=“zhangsan”）向 正式数据库 中查询数据。

3、将查询结果组装成一定格式的数据，并返回给被调用者。

4、人工或通过工具的断言功能检查接口测试的正确性。

接口自动化测试项目，为了使接口测试对数据变得可控，测试过程如下：

1、接口测试项目先向 测试数据库 中插入测试数据（zhangsan 的个人信息）。

2、调用被测系统接口（传参 username=“zhangsan”）。

3、系统接口根据传参（username=“zhangsan”）向测试数据库中进行查询并得到 zhangsan 个人信息。

4、将查询结果组装成一定格式的数据，并返回给被调用者。

5、通过单元测试框架断言接口返回的数据（zhangsan 的个人信息），并生成测试报告。

为了使正式数据库的数据不被污染，建议使用独立的 测试数据库 。

2、requests库

Requests 使用的是 urllib3，因此继承了它的所有特性。Requests 支持 HTTP 连接保持和连接池 ，支持 使用cookie保持会话 ，支持 文件上传 ，支持 自动确定响应内容的编码。 对request库的更详细的介绍可以看我之前接口测试基础的文章：

http://www.jb51.net/article/122571.htm?pc

http://www.jb51.net/article/108168.htm

3、接口测试代码示例

下面以之前用 python+django 开发的用户签到系统为背景，展示接口测试的代码。

为什么开发接口？开发的接口主要给谁来用？

前端和后端分离是近年来 Web 应用开发的一个发展趋势。这种模式将带来以下优势：

1、后端可以不用必须精通前端技术（HTML/JavaScript/CSS），只专注于数据的处理，对外提供 API 接口。

2、前端的专业性越来越高，通过 API 接口获取数据，从而专注于页面的设计。

3、前后端分离增加接口的应用范围，开发的接口可以应用到 Web 页面上，也可以应用到移动 APP 上。

在这种开发模式下，接口测试工作就会变得尤为重要了。

开发实现的接口代码示例：

添加发布会接口实现

def add_event(request):
eid = request.POST.get(‘eid’,’’) # 发布会id
name = request.POST.get(‘name’,’’) # 发布会标题
limit = request.POST.get(‘limit’,’’) # 限制人数
status = request.POST.get(‘status’,’’) # 状态
address = request.POST.get(‘address’,’’) # 地址
start_time = request.POST.get(‘start_time’,’’) # 发布会时间

if eid ==’’ or name == ‘’ or limit == ‘’ or address == ‘’ or start_time == ‘’:
return JsonResponse({‘status’:10021,‘message’:‘parameter error’})

result = Event.objects.filter(id=eid)
if result:
return JsonResponse({‘status’:10022,‘message’:‘event id already exists’})

result = Event.objects.filter(name=name)
if result:
return JsonResponse({‘status’:10023,‘message’:‘event name already exists’})

if status == ‘’:
status = 1

try:
Event.objects.create(id=eid,name=name,limit=limit,address=address,status=int(status),start_time=start_time)
except ValidationError:
error = ‘start_time format error. It must be in YYYY-MM-DD HH:MM:SS format.’
return JsonResponse({‘status’:10024,‘message’:error})

return JsonResponse({‘status’:200,‘message’:‘add event success’})
通过POST请求接收发布会参数：发布会id、标题、人数、状态、地址和时间等参数。

首先，判断eid、name、limit、address、start_time等字段均不能为空，否则JsonResponse()返回相应的状态码和提示。JsonResponse()是一个非常有用的方法，它可以直接将字典转化成Json格式返回到客户端。

接下来，判断发布会id是否存在，以及发布会名称（name）是否存在；如果存在将返回相应的状态码和 提示信息。

再接下来，判断发布会状态是否为空，如果为空，将状态设置为1（True）。

最后，将数据插入到 Event 表，在插入的过程中如果日期格式错误，将抛出 ValidationError 异常，接收 该异常并返回相应的状态和提示，否则，插入成功，返回状态码200和“add event success”的提示。

发布会查询接口实现

def get_event_list(request):

eid = request.GET.get(“eid”, “”) # 发布会id
name = request.GET.get(“name”, “”) # 发布会名称

if eid == ‘’ and name == ‘’:
return JsonResponse({‘status’:10021,‘message’:‘parameter error’})

if eid != ‘’:
event = {}
try:
result = Event.objects.get(id=eid)
except ObjectDoesNotExist:
return JsonResponse({‘status’:10022, ‘message’:‘query result is empty’})
else:
event[‘eid’] = result.id
event[‘name’] = result.name
event[‘limit’] = result.limit
event[‘status’] = result.status
event[‘address’] = result.address
event[‘start_time’] = result.start_time
return JsonResponse({‘status’:200, ‘message’:‘success’, ‘data’:event})

if name != ‘’:
datas = []
results = Event.objects.filter(name__contains=name)
if results:
for r in results:
event = {}
event[‘eid’] = r.id
event[‘name’] = r.name
event[‘limit’] = r.limit
event[‘status’] = r.status
event[‘address’] = r.address
event[‘start_time’] = r.start_time
datas.append(event)
return JsonResponse({‘status’:200, ‘message’:‘success’, ‘data’:datas})
else:
return JsonResponse({‘status’:10022, ‘message’:‘query result is empty’})
通过GET请求接收发布会id和name 参数。两个参数都是可选的。首先，判断当两个参数同时为空，接口返回状态码10021，参数错误。

如果发布会id不为空，优先通过id查询，因为id的唯一性，所以，查询结果只会有一条，将查询结果 以 key:value 对的方式存放到定义的event字典中，并将数据字典作为整个返回字典中data对应的值返回。

name查询为模糊查询，查询数据可能会有多条，返回的数据稍显复杂；首先将查询的每一条数据放到一 个字典event中，再把每一个字典再放到数组datas中，最后再将整个数组做为返回字典中data对应的值返回。

接口测试代码示例

#查询发布会接口测试代码
import requests

url = “http://127.0.0.1:8000/api/get_event_list/”
r = requests.get(url, params={‘eid’:‘1’})
result = r.json()
print(result)
assert result[‘status’] == 200
assert result[‘message’] == “success”
assert result[‘data’][‘name’] == “xx 产品发布会”
assert result[‘data’][‘address’] == “北京林匹克公园水立方”
assert result[‘data’][‘start_time’] == “2016-10-15T18:00:00”
因为“发布会查询接口”是GET类型，所以，通过requests库的get()方法调用，第一个参数为调用接口的URL地址，params设置接口的参数，参数以字典形式组织。

json()方法可以将接口返回的json格式的数据转化为字典。

接下来就是通过 assert 语句对接字典中的数据进行断言。分别断言status、message 和data的相关数据等。

使用unittest单元测试框架开发接口测试用例

#发布会查询接口测试代码
import unittest
import requests

class GetEventListTest(unittest.TestCase):

def setUp(self):
self.base_url = “http://127.0.0.1:8000/api/get_event_list/”

def test_get_event_list_eid_null(self):
‘’’ eid 参数为空 ‘’’
r = requests.get(self.base_url, params={‘eid’:’’})
result = r.json()
self.assertEqual(result[‘status’], 10021)
self.assertEqual(result[‘message’], ‘parameter error’)

def test_get_event_list_eid_error(self):
‘’’ eid=901 查询结果为空 ‘’’
r = requests.get(self.base_url, params={‘eid’:901})
result = r.json()
self.assertEqual(result[‘status’], 10022)
self.assertEqual(result[‘message’], ‘query result is empty’)

def test_get_event_list_eid_success(self):
‘’’ 根据 eid 查询结果成功 ‘’’
r = requests.get(self.base_url, params={‘eid’:1})
result = r.json()
self.assertEqual(result[‘status’], 200)
self.assertEqual(result[‘message’], ‘success’)
self.assertEqual(result[‘data’][‘name’],u’mx6发布会’)
self.assertEqual(result[‘data’][‘address’],u’北京国家会议中心’)

def test_get_event_list_nam_result_null(self):
‘’’ 关键字‘abc’查询 ‘’’
r = requests.get(self.base_url, params={‘name’:‘abc’})
result = r.json()
self.assertEqual(result[‘status’], 10022)
self.assertEqual(result[‘message’], ‘query result is empty’)

def test_get_event_list_name_find(self):
‘’’ 关键字‘发布会’模糊查询 ‘’’
r = requests.get(self.base_url, params={‘name’:‘发布会’})
result = r.json()
self.assertEqual(result[‘status’], 200)
self.assertEqual(result[‘message’], ‘success’)
self.assertEqual(result[‘data’][0][‘name’],u’mx6发布会’)
self.assertEqual(result[‘data’][0][‘address’],u’北京国家会议中心’)
49if name == ‘main’:
unittest.main()
unittest单元测试框架可以帮助 组织和运行接口测试用例。

4、接口自动化测试框架实现

关于接口自动化测试，unittest 已经帮我们做了大部分工作，接下来只需要 集成数据库操作 ，以及 HTMLTestRunner测试报告生成 扩展即可。

框架结构如下图：

pyrequests 框架：

db_fixture/： 初始化接口测试数据。

interface/： 用于编写接口自动化测试用例。

report/： 生成接口自动化测试报告。

db_config.ini ： 数据库配置文件。

HTMLTestRunner.py unittest 单元测试框架扩展，生成 HTML 格式的测试报告。

run_tests.py ： 执行所有接口测试用例。

4.1、数据库配置

首先，需要修改被测系统将数据库指向测试数据库。以 MySQL数据库为例，针对 django 项目而言，修改…/guest/settings.py 文件。可以在系统测试环境单独创建一个测试库。 这样做的目的是让接口测试的数据不会清空或污染到功能测试库的数据。 其他框架开发的项目与django项目类似，这个工作一般由开发同学完成，我们测试同学更多关注的是测试框架的代码。

4.2、框架代码实现

4.2.1、首先，创 建数据库配置文件…/db_config.ini

4.2.2、接下来， 简单封装数据库操作，数据库表数据的插入和清除 ，…/db_fixture/ mysql_db.py

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
import pymysql.cursors
import os
import configparser as cparser

======== Reading db_config.ini setting ===========

base_dir = str(os.path.dirname(os.path.dirname(file)))
base_dir = base_dir.replace(’\’, ‘/’)
file_path = base_dir + “/db_config.ini”

cf = cparser.ConfigParser()

cf.read(file_path)
host = cf.get(“mysqlconf”, “host”)
port = cf.get(“mysqlconf”, “port”)
db = cf.get(“mysqlconf”, “db_name”)
user = cf.get(“mysqlconf”, “user”)
password = cf.get(“mysqlconf”, “password”)

======== MySql base operating ===================

class DB:

def init(self):
try:
# Connect to the database
self.connection = pymysql.connect(host=host,
port=int(port),
user=user,
password=password,
db=db,
charset=‘utf8mb4’,
cursorclass=pymysql.cursors.DictCursor)
except pymysql.err.OperationalError as e:
print(“Mysql Error %d: %s” % (e.args[0], e.args1))

clear table data

def clear(self, table_name):
# real_sql = "truncate table " + table_name + “;”
real_sql = "delete from " + table_name + “;”
with self.connection.cursor() as cursor:
cursor.execute(“SET FOREIGN_KEY_CHECKS=0;”)
cursor.execute(real_sql)
self.connection.commit()

insert sql statement

def insert(self, table_name, table_data):
for key in table_data:
table_data[key] = “’”+str(table_data[key])+"’"
key = ‘,’.join(table_data.keys())
value = ‘,’.join(table_data.values())
real_sql = “INSERT INTO " + table_name + " (” + key + “) VALUES (” + value + “)”
#print(real_sql)

with self.connection.cursor() as cursor:
  cursor.execute(real_sql)

self.connection.commit()

close database

def close(self):
self.connection.close()

init data

def init_data(self, datas):
for table, data in datas.items():
self.clear(table)
for d in data:
self.insert(table, d)
self.close()

if name == ‘main’:

db = DB()
table_name = “sign_event”
data = {‘id’:1,‘name’:‘红米’,’limit’:2000,‘status’:1,‘address’:‘北京会展中心’,‘start_time’:‘2016-08-20 00:25:42’}
table_name2 = “sign_guest”
data2 = {‘realname’:‘alen’,‘phone’:12312341234,‘email’:‘[email protected]’,‘sign’:0,‘event_id’:1}

db.clear(table_name)
db.insert(table_name, data)
db.close()
首先，读取 db_config.ini 配置文件。 创建 DB 类，init()方法初始化，通过 pymysql.connect()连接数据库。

因为这里只用到数据库表的清除和插入，所以只创建 clear()和 insert()两个方法。其中，insert()方法对数 据的插入做了简单的格式转化，可将字典转化成 SQL 插入语句，这样格式转化了方便了数据库表数据的创建。

最后，通过 close()方法用于关闭数据库连接。

4.2.3、接下来接下来 创建测试数据 ，…/db_fixture/ test_data.py

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
import sys
sys.path.append(’…/db_fixture’)
try:
from mysql_db import DB
except ImportError:
from .mysql_db import DB

create data

datas = {
‘sign_event’:[
{‘id’:1,‘name’:‘红米Pro发布会’,’limit’:2000,‘status’:1,‘address’:‘北京会展中心’,‘start_time’:‘2017-08-20 14:00:00’},
{‘id’:2,‘name’:‘可参加人数为0’,’limit’:0,‘status’:1,‘address’:‘北京会展中心’,‘start_time’:‘2017-08-20 14:00:00’},
{‘id’:3,‘name’:‘当前状态为0关闭’,’limit’:2000,‘status’:0,‘address’:‘北京会展中心’,‘start_time’:‘2017-08-20 14:00:00’},
{‘id’:4,‘name’:‘发布会已结束’,’limit’:2000,‘status’:1,‘address’:‘北京会展中心’,‘start_time’:‘2001-08-20 14:00:00’},
{‘id’:5,‘name’:‘小米5发布会’,’limit’:2000,‘status’:1,‘address’:‘北京国家会议中心’,‘start_time’:‘2017-08-20 14:00:00’},
],
‘sign_guest’:[
{‘id’:1,‘realname’:‘alen’,‘phone’:13511001100,‘email’:‘[email protected]’,‘sign’:0,‘event_id’:1},
{‘id’:2,‘realname’:‘has sign’,‘phone’:13511001101,‘email’:‘[email protected]’,‘sign’:1,‘event_id’:1},
{‘id’:3,‘realname’:‘tom’,‘phone’:13511001102,‘email’:‘[email protected]’,‘sign’:0,‘event_id’:5},
],
}

Inster table datas

def init_data():
DB().init_data(datas)

if name == ‘main’:
init_data()
init_data()函数用于读取 datas 字典中的数据，调用 DB 类中的 clear()方法清除数据库，然后，调用 insert() 方法插入表数据。

4.2.4、编写 接口测试用例 。创建添加发布会接口测试文件…/interface/ add_event_test.py

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
import unittest
import requests
import os, sys
parentdir = os.path.dirname(os.path.dirname(os.path.abspath(file)))
sys.path.insert(0, parentdir)
from db_fixture import test_data

class AddEventTest(unittest.TestCase):
‘’’ 添加发布会 ‘’’

def setUp(self):
self.base_url = “http://127.0.0.1:8000/api/add_event/”

def tearDown(self):
print(self.result)

def test_add_event_all_null(self):
‘’’ 所有参数为空 ‘’’
payload = {‘eid’:’’,’’:’’,‘limit’:’’,‘address’:"",‘start_time’:’’}
r = requests.post(self.base_url, data=payload)
self.result = r.json()
self.assertEqual(self.result[‘status’], 10021)
self.assertEqual(self.result[‘message’], ‘parameter error’)

def test_add_event_eid_exist(self):
‘’’ id已经存在 ‘’’
payload = {‘eid’:1,‘name’:‘一加4发布会’,‘limit’:2000,‘address’:“深圳宝体”,‘start_time’:‘2017’}
r = requests.post(self.base_url, data=payload)
self.result = r.json()
self.assertEqual(self.result[‘status’], 10022)
self.assertEqual(self.result[‘message’], ‘event id already exists’)

def test_add_event_name_exist(self):
‘’’ 名称已经存在 ‘’’
payload = {‘eid’:11,‘name’:‘红米Pro发布会’,‘limit’:2000,‘address’:“深圳宝体”,‘start_time’:‘2017’}
r = requests.post(self.base_url,data=payload)
self.result = r.json()
self.assertEqual(self.result[‘status’], 10023)
self.assertEqual(self.result[‘message’], ‘event name already exists’)

def test_add_event_data_type_error(self):
‘’’ 日期格式错误 ‘’’
payload = {‘eid’:11,‘name’:‘一加4手机发布会’,‘limit’:2000,‘address’:“深圳宝体”,‘start_time’:‘2017’}
r = requests.post(self.base_url,data=payload)
self.result = r.json()
self.assertEqual(self.result[‘status’], 10024)
self.assertIn(‘start_time format error.’, self.result[‘message’])

def test_add_event_success(self):
‘’’ 添加成功 ‘’’
payload = {‘eid’:11,‘name’:‘一加4手机发布会’,‘limit’:2000,‘address’:“深圳宝体”,‘start_time’:‘2017-05-10 12:00:00’}
r = requests.post(self.base_url,data=payload)
self.result = r.json()
self.assertEqual(self.result[‘status’], 200)
self.assertEqual(self.result[‘message’], ‘add event success’)

if name == ‘main’:
test_data.init_data() # 初始化接口测试数据
unittest.main()
在测试接口之前，调用test_data.py文件中的init_data()方法初始化数据库中的测试数据。

创建AddEventTest测试类继承 unittest.TestCase 类，通过创建测试用例，调用相关接口，并验证接口返回 的数据。

4.2.5、创建 run_tests.py 文件

当开发的接口达到一定数量后，就需要考虑 分文件分目录 的来 划分 接口测试用例，如何批量的执行不同文件目录下的用例呢？unittest单元测试框架提供的 discover() 方法可以帮助我们做到这一点。并使用 HTMLTestRunner 扩展生成 HTML 格式的测试报告。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
import time, sys
sys.path.append(’./interface’)
sys.path.append(’./db_fixture’)
from HTMLTestRunner import HTMLTestRunner
import unittest
from db_fixture import test_data

指定测试用例为当前文件夹下的 interface 目录

test_dir = ‘./interface’
discover = unittest.defaultTestLoader.discover(test_dir, pattern=’*_test.py’)

if name == “main”:
test_data.init_data() # 初始化接口测试数据

now = time.strftime("%Y-%m-%d %H_%M_%S")
filename = ‘./report/’ + now + ‘_result.html’
fp = open(filename, ‘wb’)
runner = HTMLTestRunner(stream=fp,
title=‘Guest Manage System Interface Test Report’,
description='Implementation Example with: ')
runner.run(discover)
fp.close()
首先，通过调用test_data.py文件中的init_data()函数来初始化接口测试数据。

使用unittest框架所提供的discover()方法，查找 interface/ 目录下，所有匹配*_test.py 的测试文件（*星 号匹配任意字符）。

HTMLTestRunner 为unittest单元测试框架的扩展，利用它所提供的HTMLTestRunner()类来替换unittest单元测试框架的TextTestRunner()类，从而生成HTML格式的测试报告。

遗憾的是HTMLTestRunner并不支持Python3.x，大家可以在网上找到适用于Python3.x的HTMLTestRunner.py文件，使用在自己的接口自动化工程中。

通过 time 的 strftime()方法获取当前时间，并且转化成一定的时间格式。作为测试报告的名称。这样做目的是是为了避免因为生成的报告的名称重名而造成报告的覆盖。最终，将测试报告存放于report/目录下面。如下图，一张完整的接口自动化测试报告。

欢迎使用Markdown编辑器

你好！ 这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章，了解一下Markdown的基本语法知识。

新的改变

我们对Markdown编辑器进行了一些功能拓展与语法支持，除了标准的Markdown编辑器功能，我们增加了如下几点新功能，帮助你用它写博客：

1. 全新的界面设计 ，将会带来全新的写作体验；
2. 在创作中心设置你喜爱的代码高亮样式，Markdown 将代码片显示选择的高亮样式 进行展示；
3. 增加了 图片拖拽 功能，你可以将本地的图片直接拖拽到编辑区域直接展示；
4. 全新的 KaTeX数学公式 语法；
5. 增加了支持甘特图的mermaid语法¹ 功能；
6. 增加了 多屏幕编辑 Markdown文章功能；
7. 增加了 焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置 等功能，功能按钮位于编辑区域与预览区域中间；
8. 增加了 检查列表 功能。

功能快捷键

撤销：Ctrl/Command + Z
重做：Ctrl/Command + Y
加粗：Ctrl/Command + B
斜体：Ctrl/Command + I
标题：Ctrl/Command + Shift + H
无序列表：Ctrl/Command + Shift + U
有序列表：Ctrl/Command + Shift + O
检查列表：Ctrl/Command + Shift + C
插入代码：Ctrl/Command + Shift + K
插入链接：Ctrl/Command + Shift + L
插入图片：Ctrl/Command + Shift + G
查找：Ctrl/Command + F
替换：Ctrl/Command + G

合理的创建标题，有助于目录的生成

直接输入1次#，并按下space后，将生成1级标题。
输入2次#，并按下space后，将生成2级标题。
以此类推，我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。

如何改变文本的样式

强调文本 强调文本

加粗文本 加粗文本

标记文本

删除文本

引用文本

H₂O is是液体。

2¹⁰ 运算结果是 1024.

插入链接与图片

链接: link.

图片:

带尺寸的图片:

居中的图片:

居中并且带尺寸的图片:

当然，我们为了让用户更加便捷，我们增加了图片拖拽功能。

如何插入一段漂亮的代码片

去博客设置页面，选择一款你喜欢的代码片高亮样式，下面展示同样高亮的 代码片.

// An highlighted block
var foo = 'bar';

生成一个适合你的列表

• 项目
  • 项目
    • 项目

1. 项目1
2. 项目2
3. 项目3

• 计划任务
• 完成任务

创建一个表格

一个简单的表格是这么创建的：

项目	Value
电脑	$1600
手机	$12
导管	$1

设定内容居中、居左、居右

使用:---------:居中
使用:----------居左
使用----------:居右

第一列	第二列	第三列
第一列文本居中	第二列文本居右	第三列文本居左

SmartyPants

SmartyPants将ASCII标点字符转换为“智能”印刷标点HTML实体。例如：

TYPE	ASCII	HTML
Single backticks	'Isn't this fun?'	‘Isn’t this fun?’
Quotes	"Isn't this fun?"	“Isn’t this fun?”
Dashes	-- is en-dash, --- is em-dash	– is en-dash, — is em-dash

创建一个自定义列表

Markdown

Text-to- HTML conversion tool

Authors

John

Luke

如何创建一个注脚

一个具有注脚的文本。²

注释也是必不可少的

Markdown将文本转换为 HTML。

KaTeX数学公式

您可以使用渲染LaTeX数学表达式 KaTeX:

Gamma公式展示 $\Gamma (n)=(n-1)!\forall n\in \mathbb{N}$ 是通过欧拉积分

$$\Gamma (z)={\int }_0^{\infty }{t}^{z-1}{e}^{-t}dt.$$

你可以找到更多关于的信息 LaTeX 数学表达式here.

新的甘特图功能，丰富你的文章

Mon 06 Mon 13 Mon 20 已完成 进行中 计划一 计划二 现有任务 Adding GANTT diagram functionality to mermaid

• 关于 甘特图 语法，参考 这儿,

UML 图表

可以使用UML图表进行渲染。 Mermaid. 例如下面产生的一个序列图：

张三 李四 王五 你好！李四, 最近怎么样? 你最近怎么样，王五？ 我很好，谢谢! 我很好，谢谢! 李四想了很长时间, 文字太长了 不适合放在一行. 打量着王五... 很好... 王五, 你怎么样? 张三 李四 王五

这将产生一个流程图。:

链接

长方形

圆

圆角长方形

菱形

• 关于 Mermaid 语法，参考 这儿,

FLowchart流程图

我们依旧会支持flowchart的流程图：

Created with Raphaël 2.2.0 开始 我的操作 确认？ 结束 yes no

• 关于 Flowchart流程图 语法，参考 这儿.

导出与导入

导出

如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到 文章导出 ，生成一个.md文件或者.html文件进行本地保存。

导入

如果你想加载一篇你写过的.md文件，在上方工具栏可以选择导入功能进行对应扩展名的文件导入，
继续你的创作。

---

1. mermaid语法说明 ↩︎

2. 注脚的解释 ↩︎