markdown写文档基础

声明

本公众号所有内容，均属微信公众号: 开源优测 所有，任何媒体、网站或个人未经授权不得转载、链接、转贴或以其他方式复制发布/发表。已经本公众号协议授权的媒体、网站，在使用时必须注明"稿件来源微信公众号：开源优测"，违者本公众号将依法追究责任。

对于经常写文档的我们，时常被排版所困扰，今天介绍如何用markdown来写日常的文档。

首先工具，笔者日常使用visual studio code来写，有丰富的markdown插件，至于配置，请百度visual studio code markdown配置即可。下面我们来看一下基本一张效果图：

左边为markdown语法写的，右边为预览效果

正常情况下掌握上图中的markdown语法足以写出好看的排版文档了，完整的语法示例如下:

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

### 分割线如下

---

### 有序列表

1.列表项1

2.列表项1

3.列表项1

### 无序列表

-列表项

-列表项

-列表项

### 表格

| 序号 | 姓名 | 年龄 | 职业 |

|---|---|---|---|

| 1 | 苦叶子 | 108 | 呵呵 |

| 2 | 开源优测 | 1 | 哈哈 |

### 引入图片

下面是引入图片的方法

格式：


示例：


### 代码块

下面是文中嵌入代码实例

```python

#! -*- coding:utf-8 -*-

importos

__author__ ="苦叶子"

if__name__=="__main__":

print("这是代码块示例")

```

### 链接

### 文本块

>开源优测

>积微速成计划

>共同成长

>1.要坚持

>2.要努力

>3.用心

### 小结

开源优测公众号所有的文章均采用markdown进行写作