Markdown使用介绍
一、Markdown是什么？
纯文本格式编写文档：来自于百度百科
Markdown是一种轻量级标记语言，创始人为约翰·格鲁伯（英语：John Gruber）。 它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
由于Markdown的轻量化、易读易写特性，并且对于图片，图表、数学式都有支持，许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息
二、markdown使用介绍
1. markdown语法介绍（同时包含python代码）
# -*- coding:utf-8 -*-
'''
pywebio markdown语法:
markdown语法: https://www.jianshu.com/p/191d1e21f7ed/
markdown图床: https://www.jianshu.com/p/ea1eb11db63f
使用GitHub做图传: https://www.cnblogs.com/ly-2019/p/11828790.html
一、标题(#+空格+正文，支持六级标题，):一级标题(#)、二级标题(##)、三级标题(###)、四级标题(####)、五级标题(#####)、六级标题(######)
二、文字
加粗:**+正文+**
斜体:*+正文+*
斜体+加粗:***+正文+***
删除线:~~+正文+~~
三、引用
>+正文，可以嵌套引用，几级引用就用几个>
四、分割线
***/或者大于三个*号
-/或者大于三个-号
五、图片
；特别注意markdown图床
六、超链接
[超链接名](超链接地址 超链接title):只支持当前页面打开，无法新开窗口
七、列表
无序列表: - + * 任何一种+空格+正文
有序列表:数字.+空格+正文
列表嵌套: 上一级和下一级之间敲三个空格
八、表格
表头|表头|表头
-|:--:|-:
内容|内容|内容
第一行: 表头
第二行: 隔开表头与正文的表示，两点: 可以设置文字位置(文字默认居左；-+正文+-,文字居中; 正文+-,文字居右)；注意 - 数量不做限制
第三行: 表格内容
九、代码
单行代码:`+正文+`(反引号)
代码块:```+换行+正文+换行+```
十、其他高级用法: 公式、流程图、HTML等，请看菜鸟驿站
https://www.runoob.com/markdown/md-advance.html
'''
from pywebio.output import put_markdown
from pywebio import start_server
def article():
'''markdown'''
put_markdown('''
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题
** 这是 文字加粗效果 **
* 这是 文字斜体效果 *
*** 这是 文字加粗且斜体效果 ***
>一级引用
>>二级引用
>>>三级引用
>>>>四级引用
>>>>>>>>>>>>>>>>>>>>>多级引用
***
-
******
[Markdown教程超链接](https://www.runoob.com/markdown/md-image.html "markdown菜鸟教程")
---
- 苹果
- 橘子
- 香蕉
- 草莓
---
+ 宝马
+ 奥迪
+ 保时捷
+ 法拉利
+ 奔驰
---
* 历史
* 英语
* 地理
* 数学
---
1. 美国
2. 中国
3. 俄罗斯
4. 英国
---
- 人口
1. 中国
2. 印度
+ 经济
1. 美国
2. 中国
***
1. 人口
- 中国
- 印度
2. 经济
* 美国
* 中国
******
工号|姓名|班级|分数
:-|:-:|-:|-:
111567121212|小明XX|2|78
111567|小丽YYYYY|3|82
111567|小娟XXXX|4|92
----
`from pywebio.output import put_markdown`
```from pywebio.input import NUMBER, TEXT
from pywebio.input import input, textarea, select, checkbox, radio, slider, actions, file_upload
from pywebio.input import input_group, input_update, input_control
from pywebio.output import put_text, put_markdown
from pywebio import start_server
def user():
info = input_group("User info",[
input(label="what's your name?", name='name', type=TEXT, help_text='input your name'),
input(label="how old are you?", name='age',type=NUMBER),
textarea(label='desicreption', name='intro'),
select('which gift you want?', name='want', options=['money', 'girl', 'car']),
checkbox('your favirote?', name='hobby', options=['python', 'java', 'c', 'c++', 'javascript']),
radio(label='your role?', name='role', options=['teacher', 'father', 'son', 'CEO']),
slider(label="process", name='process', max_value=12, min_value=0, step=2),
actions(label='action', name='action', buttons=['点击我','love me']),
file_upload(label='file', name='file'),
])
put_text('insert data successful!')
put_markdown("""# I Kill YOU!""")
if __name__=="__main__":
start_server(user, debug=True, port=8080)```
''')
if __name__=="__main__":
start_server(article, debug=True, port=8090)
代码执行效果如下：
markdown效果图
2. 几个技术点
- 上面的例子使用 python中三方库 pywebio模块，将markdown文本内容输出到网页中。
- markdown中使用了一个图床技术（Gitee+PicGo），实现图片在线访问，可以学习如下博客：
markdown图床: https://www.jianshu.com/p/ea1eb11db63f
使用GitHub做图传: https://www.cnblogs.com/ly-2019/p/11828790.html
总结
提示：这里对文章进行总结：
例如：以上就是今天要讲的内容，本文仅仅简单介绍了pandas的使用，而pandas提供了大量能使我们快速便捷地处理数据的函数和方法。