Markdown 学习笔记

Posted 2020-08-15

Markdown 学习笔记

一、 Markdown 介绍

Markdown 是一种兼容html的书写语言。 要在Markdown中使用HTML语法，有以下要求：

1. 必须在区块元素（div, table, pre, p等）的开标签前和闭标签后用空行与其他内容隔开；

2. 开闭标签不能用tab或者空格缩进。

二、Markdown 语法

1. 标题

   使用 ‘#‘ 来标示标题，‘#‘越多，字体越小，最多支持6级标题。在‘#‘之后需要有个空格与内容隔开。

2. 引用

   使用‘>‘，用法同标题的‘#‘

3. 列表

   使用‘+‘或‘*‘或‘-‘开头，作为无序列表的标记

   使用‘1.‘，作为有序列表的标记

   为了避免不小心产生了列表，可以把‘.‘转义，如1998\.

4. 代码块

   在一个新行中使用两个tab进行缩进即可

   或者使用两个```包含住代码块（三个tab键上面的上撇号）

5. 分割线

   在一行中使用连续的三个‘-‘或‘*‘，或‘_‘，行内无其他字符

6. 链接

   [显示的内容](网址) 用这种方式可以使得“显示的内容变成超链接导向圆括号里面的网址”，用法就是中括号括住显示的内容，紧跟着一个圆括号，括住网址

   例如： This is a [link](http://example.com)

   显示效果为: This is a link

   [显示的内容](网址 ”当鼠标移上去之后显示的title信息”) 用这种方式可以使得“显示的内容变成超链接导向圆括号里面的网址”，用法就是中括号括住显示的内容，紧跟着一个圆括号，括住网址，网址后面空一格然后加一个双引号，引号里面就是当鼠标移到显示的内容上面的时候显示的信息。

   例如： This is a [link](http://example.com “Hello”)

   显示效果为: This is a link

   使用隐式链接标记

   [Google][][Google]: http://google.com>

   使用一个代号，代替网址内容

   例如：

   This is a [link][id]

   [id]: http://example.com "Hello" 这里的Hello可以去掉，其实就是上一种用法的Title

7. 代码

   一行代码的可以使用两个反引号 `（tab键上面的那个键），两个反引号包括住的代码会显示成代码行

   代码块的包含可以使用三个反引号开启，然后使用三个反引号结束， 也可以使用两个tab缩进然后形成代码块

8. 图片

   ![图片的替代文字](图片的网址 "鼠标移上去之后显示的title信息")

   使用一个代号，代替网址内容，用法类似链接

   ![图片的替代文字][id][id]: url/to/image "optional title attribute"

9. 自动链接

   使用尖括号包含住网址或者邮箱地址，可以自动转换成链接

10. 粗体

    **内容**，那么内容就是显示为粗体

11. 斜体

    *内容*， 那么内容就会显示为斜体

    ***内容***， 那么内容就是显示为加粗的斜体

12. 表格

    | Tables        | Are           | Cool  || ------------- |:-------------:| -----:|| col 3 is      | right-aligned | $1600 || col 2 is      | centered      |   $12 || zebra stripes | are neat      |    $1 |

    语法解释：

    1.每行第一个|和最后一个|可以省略；

    2.内容和 |之间的多余空格会被忽略，定义表格格式的时候的‘-‘至少要有一个，但为了美观可以多加几个-；

    3.|， :， -之间的多余空格会被忽略；

    4.-:表示内容和标题栏（就是所在的那一列）居右， :-表示居左， :-:表示居中，如果只有-没有:，意思该列默认为标题栏居中，内容居左。

    显示效果为:

Tables	Are	Cool
col 3 is	right-aligned	$1600
col 2 is	centered	$12
zebra stripes	are neat	$1