Markdown基础使用

最近在尝试开始写博客,然后发现格式、排版这些比较麻烦且琐碎,所以希望能够有一个简单易用的编写工具。基于这个原因,便开始学习了一下Markdown,发现挺有趣的,所以在这里整理一下各种基础的使用,将各种用法进行一些简单的串联,方便后面的记忆和使用。

在学习中,主要参考的是RUNOOB。将它里面的卡片串联在这一篇文章中。

推荐使用软件Typora,所见即所得。

说明:下面的所有展示效果,有效展示部分都是第一条竖线后面的内容。加上最外层的竖线主要是为了与原始文本内容做区分。


一、标题

支持使用等号 = 和减号 - 来标记,总共分为6级标题,按照符号个数分别为一级标题到六级标题。在符号后面使用一个空格将标题和内容分离。比如下面这段:

# 一级标题
## 二级标题
###### 六级标题,超过六个无效,#和标题之间使用空格隔开

其展示效果如下:

一级标题

二级标题

六级标题,超过六个无效,#和标题之间使用空格隔开

二、段落

包括段落的编排、字体设置、分割线、删除线、下划线和脚注的使用。

1、段落编排

段落的换行有两种方式,一种是在一个段落的末尾使用两个空格然后换行写下一段落,另一种方式是中间使用空行来换行。两者之间经过实测在展示效果上有些差别,使用空行进行换行的段落之间空隙要大于使用两个空格进行换行的空隙。比如下面这段:

***
(使用两个空格来换行)第一段  
(使用两个空格来换行)第二段
***
(使用空行来换行)第一段内容

(使用空行来换行)第二段内容
***

其展示效果如下:


(使用两个空格来换行)第一段
(使用两个空格来换行)第二段


(使用空行来换行)第一段内容

(使用空行来换行)第二段内容


2、字体

支持使用斜体、粗体、粗斜体三种字体。使用单个*或者下划线_包围文本表示将文本显示为斜体,使用两个星号或者两个下划线包围文本表示将文本显示为粗体,三个星号或者三个下划线就是将包围的文本显示为粗斜体。比如下面这段:

*使用星号标记的斜体文本*
_使用下划线标记的斜体文本_
**使用两个星号加粗**
__使用两个下划线加粗__
***使用三个星号加粗斜体***
___使用三个下划线加粗斜体___

其展示效果如下:

使用星号标记的斜体文本
使用下划线标记的斜体文本
使用两个星号加粗
使用两个下划线加粗
使用三个星号加粗斜体
使用三个下划线加粗斜体

3、分割线

上面分割线已经使用的足够多了。可以使用三个及以上的星号、减号、下划线来表示一条分割线,分割线行内不能有其它内容,可以在星号、减号、下划线中间插入空格。比如下面这段:

***
* * *
*****
- - -
----------

其展示效果如下:






4、删除线和下划线

使用两个波浪线~~包围文本即可表示删除线,使用<u></u>这对标签包围文本即可表示下划线。比如下面这段:

~~使用两个波浪线包围起来表示删除线~~
<u>使用这对标签包围起来表示下划线</u>

其展示效果如下:

使用两个波浪线包围起来表示删除线
使用这对标签包围起来表示下划线

5、脚注

使用[]这个符号来标记脚注内容,内容放在[后面。比如下面这段:

什么是脚注?[^这就是一段脚注]

其展示效果如下:

什么是脚注?[^这就是一段脚注]


三、列表

列表是文章中经常使用到的项,分为有序列表和无序列表。无序列表使用星号*、加号+或者减号-来进行标记,这些标记后面要添加一个空格,然后再填写内容。有序列表则是使用数字并加上.号来表示。比如下面这段:

### 无序列表
* 第一项
* 第二项
+ 第三项
- 第四项
### 有序列表
1. 第一项
2. 第二项
3. 第三项

其展示效果如下:

无序列表

  • 第一项
  • 第二项
  • 第三项
  • 第四项

有序列表

  1. 第一项
  2. 第二项
  3. 第三项

而列表与列表之间也可以是任意嵌套的,对于列表嵌套只需要在选项前面添加四个空格即可。比如下面这段:

* 第一项
  * 第1项
  * 第2项
  * 第3项
* 第二项
  * 第二项第一级嵌套
    * 第二项第三级嵌套
* 第三项
  1. 第1项
  2. 第2项

其展示效果如下:

  • 第一项
    • 第1项
    • 第2项
    • 第3项
  • 第二项
    • 第二项第一级嵌套
      • 第二项第三级嵌套
  • 第三项
    1. 第1项
    2. 第2项

四、区块

如上,各个展示效果都是放在区块中进行展示的,使用>符号进行表示,一个>符合表示最外层,两个>符号表示第一层的嵌套,以此类推。比如下面这段:

> 第一层指示-1
>> 第一层指示分类点1
>> 第一层指示分类点2
>
> 第一层指示-2
>
> 第一层指示-3
注意:如果上一层级的子嵌套要结束,然后恢复到上一层级,中间要使用一个 '> 空行' 来分隔

其展示效果如下:

第一层指示-1

第一层指示分类点1
第一层指示分类点2

第一层指示-2

第一层指示-3

注意:如果上一层级的子嵌套要结束,然后恢复到上一层级,中间要使用一个 '> 空行' 来分隔

同时区块可以结合列表来使用,其实在上面的展示中就已经使用到了。


五、代码

在上面各段代码中展示的markdown语句,之所以没有按照展示效果中的样式解析出来,就是因为包含在了代码块中。使用三个波浪线~~~来包裹一段代码,并指定一种语言,也可以不指定。比如下面这段:

​~~~markdown
### 这是一段代码
​~~~

其展示效果如下:

### 这是一段代码

(### 这是一段代码 ) 依然没有被解析为三级标题。


六、链接

比如下面这段:

RUNOOB链接 [RUNOOB](https://www.runoob.com)

其展示效果如下:

RUNOOB链接 RUNOOB


七、图片

图片这个有点不好用,typora不方便将本地的图片复制到其他地方去,比如在本地编写好文章,里面插入图片,然后复制到其它发布平台是没法复制过去的。而有一些编辑器使用图片上传功能需要付费。这里就复制一下它的样例吧,如下:

![RUNOOB 图标](http://static.runoob.com/images/runoob-logo.png)

其展示效果如下:

RUNOOB 图标


八、表格

表格使用当然是必不可少的。使用|来分隔不同的单元格,使用-来分隔表头和其它行。同时可以设置表格的对齐方式,如下:

  • -: 设置内容和标题栏右对齐
  • :- 设置内容和标题栏左对齐
  • :-: 设置内容和标题栏居中对齐

比如下面这段:

| 左对齐 | 居中对齐 | 右对齐 |
| :---- | :----:  | ----: |
| 单元格 | 单元格   | 单元格 |
| 单元格 | 单元格   | 单元格 |

其展示效果如下:

左对齐 居中对齐 右对齐
单元格 单元格 单元格
单元格 单元格 单元格

九、转义

在上面的文档中出现了各种Markdown的特殊字符,但是依然原样显示出来,没有被解析成为各种样式,就是使用了转义字符 \,使用\就表示后面的字符要原样输出,不要进行解析。比如我要显示三个星号而不是分隔线,对应如下:

\*\*\*

其展示效果如下:

***


十、高级技巧

看了一下Markdown甚至支持使用HTML元素,各种数学公式、流程图、时序图、甘特图支持,真的是太强大了。

后面有时间了再来完整的整理一下Markdown的高级用法~~~

posted @ 2020-12-29 17:46  小白先生哦  阅读(470)  评论(0编辑  收藏  举报