MarkDown的使用教程综合教程

MarkDown的使用教程综合教程

1.前言

本章节汇总了MarkDown的综合使用，来完成一篇具有格式的论文。

论文以《XX 管理系统设计与实现》作为题目，包含毕业论文所需的主要对象，如标题、段落、设计图、表格、引用等。只为体现格式与排版效果，内容纯属虚构。

2.语法详解

2.1文章结构规划

一篇完整的论文需要包含封面、摘要、目录、正文（绪论、需求分析、概要设计、功能实现、系统测试）、结束语、致谢、参考文献。我们用一级标题表示以上内容。方式如下：

实例 1：

用一级标题划分文章结构，并用注释简述该部分的核心内容。

# 摘要



# 目录



# 第一章 绪论



# 第二章 需求分析



# 第三章 概要设计



# 第四章 功能实现



# 第五章 系统测试



# 结束语



# 致谢



# 参考文献

其渲染效果如下：

2.2 摘要部分

摘要部分通常为一大段普通文字加关键词，其中「关键词」三个字要加粗强调显示。

实例 2：

摘要的实例。

# 摘要

这里插入任意的文本内容。

...

这里插入任意的文本内容。

**关键词**：编辑器，格式化，Markdown。

其渲染效果如下：

2.3 绪论部分

绪论部分已文字为主，适当增加引用。

实例 3：

绪论部分的实例。

# 第一章 绪论

## 1.1 课题背景

[这是一段正文内容]

>引用他人的论点论据，用来佐证本文的背景及意义。
>
>——引文出处，适当增加尾注[^1]

[这是一段正文内容]

## 1.2 信息化管理

## 1.3 系统设计目的和内容

[^1]: 绪论尾注 1 的内容。

其渲染效果如下：

2.4 需求分析

需求分析一般包含可行性分析、业务需求、数据项分析。

实例 4：

需求分析实例。

# 第二章 需求分析

## 2.1 可行性分析

### 2.1.1 技术可行性

同类产品技术解决方案：

- XX 公司实现的产品，用了 XX 技术；
- XX 公司实现的产品，用了 XX 技术；
- XX 公司实现的产品，用了 XX 技术。

### 2.1.2 经济可行性

​```mermaid
pie title 市场分析
    "已改造" : 386
    "未改造" : 85
​```

图1：市场分析图

### 2.1.3 管理可行性

## 2.2 需求分析

### 2.2.1 功能需求

- 功能点1
  - 子功能点 1-1
  - 子功能点 1-2
  - 子功能点 1-3
- 功能点2
  - 子功能点 2-1
  - 子功能点 2-2
- 功能点3

### 2.2.2 环境需求

| 需求项   | 需求指标  |
| -------- | --------- |
| 操作系统 | CentOS 7  |
| 数据库   | Mysql 5.7 |
| 内存     | 8G        |
| 硬盘     | 100G      |

## 2.3 数据项分析

数据表整理

| 数据对象 | 简述               | 来源     | 核心数据项   | 主键   |
| -------- | ------------------ | -------- | ------------ | ------ |
| 管理员表 | 保存系统管理员信息 | 注册     | 登录名       | 登录名 |
| 学生表   | 保存学员信息       | 批量导入 | 姓名、学号   | 学号   |
| 老师表   | 保存教职工信息     | 批量导入 | 姓名、职工号 | 职工号 |
| 部门表   | 保存部门、班级信息 | 批量导入 | 名称、编号   | 编号   |

其渲染效果如下：

2.5 概要设计

设计部分以图表形式的内容最多。

实例 5：

# 第三章 概要设计

## 3.1 数据表设计

**管理员表**

管理员表的描述文字。

*表1：管理员表结构*

| 列名     | 数据类型    | 长度 | 非空 | 主键 |
| -------- | ----------- | ---- | ---- | ---- |
| id       | UUID        | 64   | √    | √    |
| account     | VARCHAR(32) | 32   | √    |      |
| password | VARCHAR(32) | 32   |      |      |

**学生信息表**

学生信息表的描述文字。

*表2：管理员表结构*

| 列名     | 数据类型    | 长度 | 非空 | 主键 |
| -------- | ----------- | ---- | ---- | ---- |
| id       | UUID        | 64   | √    | √    |
| name     | VARCHAR(32) | 32   | √    |      |
| age | Integer | 8   |      |      |

## 3.2 数据表关系图

​```mermaid
classDiagram
	学员表 --> 部门表 : 关联
	职工表	--> 部门表 : 关联
	class 学员表 {
    id
    部门 ID 
	}
	class 职工表 {
    id
    部门 ID 
	}
	class 部门表 {
    id
	}
​```

图3-1：数据关系表

## 3.3 功能结构图

​```mermaid
graph LR
	XX管理系统 --> 管理员登录
	管理员登录 --> 系统设置
	管理员登录 --> 学员管理
  管理员登录 --> 教师管理
 	管理员登录 --> 部门管理
 	部门管理 --> 增加
 	部门管理 --> 修改
 	部门管理 --> 删除
 	部门管理 --> 批量导入
​```

图3-2：功能结构图

其渲染效果如下：

2.6 功能实现

系统功能实现部分多以代码和截图为主。

# 第四章 功能实现

## 4.1 后台代码实现

​```java
public class Starter {
	public static void main(String[] args) {
  	System.out.println("Hello world");
  }
}
​```

## 4.2 前端代码实现

前端 HTML 代码：

​```html


  
  
    
Hello world.
  

​```

前端脚本代码：

​```javascript
function main() {
	alert("Hello world!");
}

window.onload = main;
​```

## 4.3 配置文件代码

properties 类型的配置文件：

​```properties
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/helloworld?characterEncoding=utf8
jdbc.username=root
jdbc.password=root
​```

## 4.4 运行及启动日志

​```bash
java Starter
---
Hello world
​```

网页截图：

![](../images/4-1.png)

图4-1：访问效果图

其渲染效果如下：

2.7 系统测试

系统测试部分多以列表及表格为主。

实例 7：

# 第五章 系统测试

## 5.1 功能点完成情况对照

- [x] 数据库创建
- [x] 后端开发
- [x] 前端开发
- [x] 接口联调
- [ ] 日志归档

## 5.2 测试结果

| 功能点       | 是否测试                     | 是否通过                     | 备注 |
| ------------ | ---------------------------- | ---------------------------- | ---- |
| 登录         | √ | √ | 无   |
| 登出         | √ | ×   | 无   |
| 增加学员信息 | ×   | ×   | 无   |

其渲染效果如下：

2.8 参考文献

参考文献部分是尾注的汇总。

正文某处[^1]

正文某处[^2]

正文某处[^3]

# 参考 文献

[^1]: XXX，图书管理系统设计。北京：北京大学出版社，2008。
[^2]: XXX，师生管理系统设计。北京：清华大学出版社，2009。
[^3]: XXX，软件工程（三）。北京：邮电大学出版社，2019。

其渲染效果如下：

2.9 为论文增加目录

在论文的目录章节后面插入 [TOC]

# 目录

@[toc]

其渲染效果如下：

3.小结部分

本节内容综合运用了前述的各个小节的知识点。

实际应用中，我们还可以通过自定义样式的方式满足课题方提出的要求，减少花费在布局、排版上的时间。

最后可以通过导出 PDF（文件 -> 导出 -> PDF）的功能，生成便于传播与发布的文档。