[Markdown] Markdown 使用笔记

在Github上放了第一个正经的项目,(之前一直当网盘存代码用,hhh)

决定写一下使用手册,算是正式进入Github(话说都加入几年了,但感觉提交的项目都很水,没有意义)

然后发现之前一直写一句话的.md文档竟然是一种标记语言格式文档,不过好像比<html>简单,学到的第一点就是:

换行不需要使用<br/>而是直接在需要换行的行末加两个空格

在这个文档里逐步完善自己使用Markdown的经验


Markdown常用语法目录

1.安装Markdown编辑器

2.Markdown的常用语法(代码+效果)

2.1 换行

2.2 空行

2.3 粗体

2.4 斜体

2.5 粗斜体 

2.6 分割线

2.7 标题 

2.8 效果叠加

2.9 有序列表

2.10 无序列表

2.11 行代码块

2.12 删除线

2.13 插入图片

2.13.1 插入网络图片

2.13.2 插入本地图片

2.14 大块代码段插入

2.15 超链接

2.16 替代标记


1.安装Markdown编辑器

我用的是Markdown 10,直接在Microsoft store搜索就能找到(界面简洁清爽,推荐)

2.Markdown的常用语法(代码+效果)

2.1 换行

换行 在行末加至少两个空格  
123    
345  
&nbsp;  

2.2 空行

空行,使用nbsp;+两个空格(如上下两行效果)  
&nbsp;  

2.3 粗体

粗体使用一对**将文字包裹   
**123**  


    

2.4 斜体

斜体使用**将要文字包裹:  
*23*  

2.5 粗斜体 

粗斜体使用一对“***”将文字包裹:  

***33***  

&nbsp;  

2.6 分割线
 

分割线就是4个*:  
****  
&nbsp; 

 

2.7 标题 

**标题**   
使用一个到六个“#”进行区分,#和文字之间有一个空格    
# 123  
## 1245  
### 1234  
#### 12345    
###### 123456  
&nbsp;  

2.8 效果叠加

效果可以叠加,例如:  
### ***一个倾斜的粗体三号标题***  
&nbsp;  

2.9 有序列表

**有序列表**  
标题使用若干符号#,列表使用“num”+“.”+"选项"构成 
# Fruit
1. apple
2. orange
3. pear

&nbsp; 

 

2.10 无序列表

**无序列表**   
标题使用若干符号#,列表使用“-/*”+"选项"构成  
## Color  
- red
- green
- blue
* purple
  
&nbsp;  

 

2.11 行代码块

**代码框** 使用一对'\`'将代码括起来(\是为了转义)  
code with py: `print("Hello, Markdown")`    
&nbsp;    

 

2.12 删除线

**删除线**  使用一对“\~~”进行删除(\是为了转义)  
~~deleted line~~   
&nbsp;  

2.13 插入图片

**插入图片** 使用![picture name](url)格式  
*url可以是本地文件协议地址*  
*也可以是互联网上的http/https协议地址*  
&nbsp;

  

2.13.1 插入网络图片

*网络图片*:  
![tree](https://upload.wikimedia.org/wikipedia/commons/thumb/2/28/%27Ommelozen_boom%27.jpg/1200px-%27Ommelozen_boom%27.jpg)
&nbsp;  

2.13.2 插入本地图片

*本地图片*: (Markdown 10这个MD编辑器 读不出来)  
![another tree](../media/img/tree.jpg)  
&nbsp;  

<!--另一种可以读的出来的方式,并添加了居中效果-->
<center><img src = "confusion-matrix.png" class="img"></center>

 

2.14 大块代码段插入

**块代码区块设置**   
&nbsp;  
(之前说过了
`Code line1   
Code line2  
Code line3  
Code line4`的用法
)  
&nbsp;  
还可以使用类似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

  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值