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

一、标题(#+空格+正文，支持六级标题，):一级标题(#)、二级标题(##)、三级标题(###)、四级标题(####)、五级标题(#####)、六级标题(######)

二、文字
    加粗:**+正文+**
    斜体:*+正文+*
    斜体+加粗:***+正文+***
    删除线:~~+正文+~~

三、引用
    >+正文，可以嵌套引用，几级引用就用几个>

四、分割线
    ***/或者大于三个*号
    -/或者大于三个-号

五、图片
    ![图片alt](图片地址 图片title)；特别注意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('''
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

** 这是 文字加粗效果 **
* 这是 文字斜体效果 *
*** 这是 文字加粗且斜体效果 ***

>一级引用
>>二级引用
>>>三级引用
>>>>四级引用
>>>>>>>>>>>>>>>>>>>>>多级引用

***
-

![gitee](https://gitee.com/cat310/pic-manager/raw/master/pic-manager/001.png "风景")
******

[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提供了大量能使我们快速便捷地处理数据的函数和方法。