markdown的语法以及使用

2019-06-06

markdown介绍

MarkDown是一种纯文本格式的标记语言,可以通过一定的的语法标记,让普通的文本具有一定的格式。

  • 优点:
    • 方便,方便,方便!
    • 学习成本低,5分钟速成!
  • 缺点:
    • 什么你说markdown有缺点?那你去用txt吧(生气气ing)。

markdown的语法介绍与使用

标题

在标题前面加符号#,一般来说一级标题加1个#,二级加2个#·····六级加6个#。最多只能有6级标题

请在#与标题中间添加一个空格

 # 一级标题  
 ## 二级标题
 ### 三级标题
 #### 四级标题
 ##### 五级标题
 ###### 六级标题

显示结果

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

字体

设置字体的样式如加粗、斜体等

  • 加粗
    在文字俩边添加俩个*符号

粗  
**粗**  

显示结果


  • 斜体
    在文字俩边添加一个*符号

斜  
*斜*  

显示结果


  • 斜体加粗
    在文件俩边添加三个*符号

斜粗  
***斜粗***  

显示结果

斜粗
斜粗

  • 删除线
    使用俩个~符号将其包裹
删除线  
~~删除线~~

显示结果

删除线
删除线

引用

就是让人看起来有一块比较深的颜色块,一般用来引用别人说过的话,代码等

> 这是一个引用内容  
>> 这是一个二级的引用内容  
>>> 这是一个三级的引用内容

内容显示

这是一个引用内容

这是一个二级的引用内容

这是一个三级的引用内容

分割线

就是一个分割线,一条横横的线条。
一般使用3个或3个以上的*符号或者-符号

***  
分割一下
****  
分割一下  
*****  
分割一下
---  
分割一下
-----  
分割一下  
------  

显示效果


分割一下


分割一下


分割一下

分割一下

分割一下

图片

就是在markdown中显示图片,基础格式是:

![描述图片的关键字(可以不写)](图片路径"鼠标放在图片上所对应的文字信息(可以不写)")      

一共有三种方式:

  • 插入本地链接
    只需要在路径的括号内写入相对路径或者绝对路劲即可

    ![假装我是关键字](/image/prcture.jpg "我是个文字信息")    
    

    缺点:不灵活不好分享,本地图片的路径更改或丢失都会造成markdown文件调不出图。

  • 插入网络图片
    只需要在路径的括号内写入网络图片的链接(下载链接)

    ![假装我是关键字](http://woshige.com/jiazhuangshigelianjie.jpg "假装我是个文字信息")  
    

    需要网络,对网速要求较高

  • 把图片存入markdown文件
    需要使用base64转码工具将图片转为一段字符串,然后将字符串填到链接的那个位置

    ![假装我是关键字](data:image/png;base64,iVBORw0......)   
    

    还有一种方法,较为高级,在编辑的时候更为简洁,方便

    ![关键字][1]  
    ![关键字][2]  
    
    [1]: http://tupian.com/tupian.jpg"这是一个关键字"   
    [2]: http://tupian.com/tupian1.jpg"这是一个关键字" 
    

超链接

语法:

[名称](ningdali.com"这是一个文字信息")

这是一个名字叫[长颈鹿](ningdali.com "长颈鹿")的人的博客,如果大家喜欢的话也可以去他的[github](https://github.com/MrDalili "github")看看哦。

显示结果

这是一个名字叫长颈鹿的人的博客,如果大家喜欢的话也可以去他的github看看哦。

还是可以使用更高级的方式来显示

这是一个名字叫[长颈鹿][1]的人的博客,如果大家喜欢的话也可以去他的[github][2]看看哦。  

[1]: ningdali.com"你把鼠标移动到我上面啦,羞羞耶"
[2]: https://github.com/MrDalili"github"

显示结果

这是一个名字叫长颈鹿的人的博客,如果大家喜欢的话也可以去他的github看看哦。

列表

就是看起来会更有层次感,无序一般是写一个-、+、*符号,在后面再加一个空格后,写入标题即可,有序列表是写1. 2. 3. 空一格空格后写入标题即可。
无序标题

+ 标题  
- 标题  
* 标题  

显示结果

  • 标题
  • 标题
  • 标题

有序标题

1. 标题1  
2. 标题2  
3. 标题3

显示结果

  1. 标题1
  2. 标题2
  3. 标题3

嵌套标题
是在一层标题中嵌套多层标题,在开展n级标题的时候,在上一级与下一级中间添加3个空格
切记一定要在前面加3个空格,还有在1.、+、-、*号与文字之间添加空格

+ 一级标题  
   + 二级标题  
      + 三级标题  
- 一级标题  
   - 二级标题  
      - 三级标题  
* 一级标题  
   * 二级标题  
      * 三级标题  
1. 第一级第一
   1. 第二级第一  
      1. 第三级第一  
         2. 第三季第二  
   2. 第二级的第二
      + 第三级的第一
      + 第三级的第二  
   3. 第二级的第三
2. 第一级第二  

显示结果

  • 一级标题
    + 二级标题
    + 三级标题
  • 一级标题
    - 二级标题
    - 三级标题
  • 一级标题
    * 二级标题
    * 三级标题
  1. 第一级第一
    1. 第二级第一
      1. 第三级第一
      2. 第三季第二
    2. 第二级的第二
      • 第三级的第一
      • 第三级的第二
    3. 第二级的第三
  2. 第一级第二

表格

表格就是显示出一个n*n的表格
语法:

表头|表头|表头  
---|:---:|---:  
内容|内容|内容  
内容|内容|内容  

第二行是用来分割表头与内容的,其中的-随便加,是用来对齐的  
|可以在第二行俩边都加,也可以省略  
在表格中文字默认左对齐  
如果要让文字中对其那么在---的俩边加:  
如果要让文字右对齐那么在---的右边加:  

名称|绰号|地址
----|---|----
tim|健力宝|https://zouchanglin.cn/
ahoj|村支书|https://ahoj.cc/
Andrew|脱裤王|http://47.106.200.88/
Rex|实话哥|http://www.luoshaoqi.cn/

显示结果

名称绰号地址
tim健力宝https://zouchanglin.cn/
ahoj村支书https://ahoj.cc/
Andrew脱裤王http://47.106.200.88/
Rex实话哥http://www.luoshaoqi.cn/

表格里面嵌套表格还没学习到,这俩天使用hexo的时候,发现了表格嵌套表格,在github上显示的是嵌套成功,不知道别的markdown支不支持。
尝试了一下,貌似只有github是那样子显示,如果可以的话,我到时候在新更新一篇文章。

代码以及代码块

代码块分为单行代码与多行代码

  • 单行代码
    使用一个反引号括起来,就是半角的波浪线符号所按出来的
`System.out.println("hello markdown");`

显示结果

System.out.println("hello markdown");

  • 多行代码
    使用三个反引号括起来
(```java) 因为为了防止与展示这段话的代码块冲突,大家使用时应将括号去除  
System.out.println("hello markdown");  
System.out.println("i like markdown");  
(```) 此处括号去除  

显示结果

System.out.println("hello markdown");
System.out.println("i like markdown");  

注意

在这里提醒大家,不要用idea写markdown,因为idea的markdown不规范,将不规范的放在规范的中会出现很多格式错误,我这篇文章真的就是写博客2小时,改博客2小时,格式全乱。

大家一定要学会遵守markdown的规范,该空格的空格,改换行的换行,多打空格和换行符准没错,给大家看一下一开始写出来的一个片段。

血泪史


标题:markdown的语法以及使用
作者:MrDalili
地址:https://www.ningdali.com/articles/2019/06/06/1569242942185.html

评论
发表评论