在Github上放了第一个正经的项目,(之前一直当网盘存代码用,hhh)
决定写一下使用手册,算是正式进入Github(话说都加入几年了,但感觉提交的项目都很水,没有意义)
然后发现之前一直写一句话的.md文档竟然是一种标记语言格式文档,不过好像比<html>简单,学到的第一点就是:
换行不需要使用<br/>而是直接在需要换行的行末加两个空格
在这个文档里逐步完善自己使用Markdown的经验
Markdown常用语法目录
1.安装Markdown编辑器
我用的是Markdown 10,直接在Microsoft store搜索就能找到(界面简洁清爽,推荐)
2.Markdown的常用语法(代码+效果)
2.1 换行
换行 在行末加至少两个空格
123
345
2.2 空行
空行,使用nbsp;+两个空格(如上下两行效果)
2.3 粗体
粗体使用一对**将文字包裹
**123**
2.4 斜体
斜体使用**将要文字包裹:
*23*
2.5 粗斜体
粗斜体使用一对“***”将文字包裹:
***33***
2.6 分割线
分割线就是4个*:
****
2.7 标题
**标题**
使用一个到六个“#”进行区分,#和文字之间有一个空格
# 123
## 1245
### 1234
#### 12345
###### 123456
2.8 效果叠加
效果可以叠加,例如:
### ***一个倾斜的粗体三号标题***
2.9 有序列表
**有序列表**
标题使用若干符号#,列表使用“num”+“.”+"选项"构成
# Fruit
1. apple
2. orange
3. pear
2.10 无序列表
**无序列表**
标题使用若干符号#,列表使用“-/*”+"选项"构成
## Color
- red
- green
- blue
* purple
2.11 行代码块
**代码框** 使用一对'\`'将代码括起来(\是为了转义)
code with py: `print("Hello, Markdown")`
2.12 删除线
**删除线** 使用一对“\~~”进行删除(\是为了转义)
~~deleted line~~
2.13 插入图片
**插入图片** 使用![picture name](url)格式
*url可以是本地文件协议地址*
*也可以是互联网上的http/https协议地址*
2.13.1 插入网络图片
*网络图片*:
![tree](https://upload.wikimedia.org/wikipedia/commons/thumb/2/28/%27Ommelozen_boom%27.jpg/1200px-%27Ommelozen_boom%27.jpg)
2.13.2 插入本地图片
*本地图片*: (Markdown 10这个MD编辑器 读不出来)
![another tree](../media/img/tree.jpg)
<!--另一种可以读的出来的方式,并添加了居中效果-->
<center><img src = "confusion-matrix.png" class="img"></center>
2.14 大块代码段插入
**块代码区块设置**
(之前说过了
`Code line1
Code line2
Code line3
Code line4`的用法
)
还可以使用类似Python的缩进格式进行代码区块化,在每行代码前加4个空格
且首行要空出来写4个空格,表示进入代码段,但最后一行不需要专门加空行
// main.cpp
#include <opencv2/opencv.hpp>
using namespace cv;
int main()
{
Mat image = imread("C:\\Users\\DELLT620\\Desktop\\cat.jpg", IMREAD_GRAYSCALE);
if (image.empty()) {
printf("Open Error\n");
return -11;
}
namedWindow("image", WINDOW_AUTOSIZE);
imshow("image", image);
waitKey(0);
return 0;
}
2.15 超链接
**超链接**:
[百度一下](https://baidu.com)
2.16 替代标记
**替代策略**:
[img][1]
// other Markdown Code here
[1]:https://upload.wikimedia.org/wikipedia/commons/thumb/2/28/%27Ommelozen_boom%27.jpg/1200px-%27Ommelozen_boom%27.jpg