首页 > 代码库 > Markdown 学习笔记

Markdown 学习笔记

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.-:表示内容和标题栏(就是所在的那一列)居右, :-表示居左, :-:表示居中,如果只有-没有:,意思该列默认为标题栏居中,内容居左。

    显示效果为:

TablesAreCool
col 3 isright-aligned$1600
col 2 iscentered$12
zebra stripesare neat$1


Markdown 学习笔记