Rancho Blog

知行合一，致良知！

0%

Markdown学习笔记

发表于 更新于 分类于 | 字数： 1.3k

Markdown学习笔记

最早接触Markdown(下面简称md)标记语言是在有道云笔记上，当时的学习计划就是用md写的,后来看到github上readme基本上
都是用md写的，到如今搭建自己的Blog,md做为主要的编写blog方式，花点时间系统学习一下md。

Markdown简介

md是一种轻量级的标记语言，md编写的文档可以导出HYML、Word、图像、PDF等多种格式的文档,md编写的文档后缀名为
.md，markdown。
md可以用来撰写电子书，帮助文档或在论坛上发表消息。例如：GitHub、简书。
个人理解，md就是比较简单的格式化文本语言。

Markdown标题

  1. 使用=和-标记一级和二级标题 
1
2
3
4
这是一级标题  
===========   
这是二级标题   
-----------

个人一般不习惯这种用法，一般采用#来标记标题
2. 使用#标记
使用#可以表示1-6级标题，一级标题对应一个#号，如下 

1
2
3
4
5
6
# 一级标题   
## 二级标题   
### 三级标题   
#### 四级标题   
##### 五级标题  
###### 六级标题

显示效果就不在这里贴图了，自己敲敲看下效果，注意#后面与标题之间有个空格，空格这种基本分割语法在md里面要注意。

Markdown段落与换行

md的换行就是在行尾加上两个以上的空格，然后换行写其他文字，有的md编辑器可能只需要回车就可以（自动加上两个空格？）,我用的是Visual Studio Code,需要自己加。段落的前后必须都是空行，空行指的是行内什么都没有。

字体

md支持以下几种字体 

1
2
3
4
5
6
*斜体文本*  
_斜体文本_
**粗体文本**  
__粗体文本__  
***粗斜体文本***  
___粗斜体文本___

斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本
建议采用*或_一种风格来书写，我使用*.

分割线

在一行中使用三个以上的星号、减号、底线来建立一个分割线，行内不能有其它东西，但可以在符号之间插入空格。建议采取一种写法就行，我采用***. 

1
***  
1
2
---  
___

效果一样。

删除线

在文字两端分别加上两个波浪线，如 

1
~~Cassiopeia~~

Cassiopeia

下划线

md和HTML语法兼容，可以通过HTML的标签来实现效果，如下： 

1
<u>下划线<\u>

下划线

脚注

脚注是对文本的补充说明，格式如下： 

1
2
需要添加脚注的文字 [^tag]。  
[^tag]: Rancho is a handsome boy!

需要添加脚注的文字 [^tag]。
[^tag]: Rancho is a handsome boy!
这里脚注显示不成功，不知道原因，在有道云里面真诚。

Markdown列表

无序列表使用*、+、-作为列表标记。
有序列表使用数字加.号来表示，如： 

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

注意.号后面的空格。

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

    列表嵌套

    列表嵌套在子列表中的选项添加四个空格：
  4. 第一项
    1. 嵌套1
    2. 嵌套2
  5. 第二项
    1. 嵌套1
    2. 嵌套2

      Markdown区块

      在段落开头使用>符号，后面加一个空格 
      1
      2
      3
      > 区块测试1  
      >> 区块测试2  
      >>> 区块测试3

      区块测试1

      区块测试2

      区块测试3

      Markdown代码块

      使用```包裹一段代码，并指定一种语言(也可以不指定)
      对于单行的代码块，用`包裹即可，代码块中的数据不会被md语法所解释。

      Markdown链接

      使用方法如下: 
      1
      2
      3
      [链接名称](链接地址)    
      或者    
      <链接地址>
      如：
      这是我的Blog Rancho

      Markdown图片

      使用方法如下: 
      1
      ![](https://rancho333.github.io/pictures/Rancho.png)

      md没法指定图片的高度与宽度，可以使用<image>标签

使用资源文件夹后，将图片资源放置在对应的文章资源文件夹里面，可以通过：

1
{% asset_img image_name.png image_name %}

来调用图片资源

Markdown表格

md使用|来分隔不同的单元格，使用-来分隔表头和其它行。在减号的不同侧加入:代表方向对齐。 

1
2
3
4
| 左对齐 | 右对齐 | 居中对齐 |  
| :---- | ----: | :-----:  |  
| 单元格 | 单元格 | 单元格 |  
| 单元格 | 单元格 | 单元格 |
左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

Markdoen高级技巧

支持HTML元素

不在md覆盖范围之内的标签，可以使用HTML的标签，如<kbd> <b> <i> <em> <sup> <sub> <br>
使用Ctrl+Alt+Del重启电脑

转义

md使用很多特殊符号表示特定的意义，如果需要显示这些特定的符号需要借助转义字符，即反斜杠.用代码块也能得到相同的效果。

公式

数学不好，看着头疼，这里就不介绍了！^-^

自动生辰目录

linux上安装doctoc可以根据md的标题自动生成目录, 使用方法为doctoc file.md

参考资料：
菜鸟教程