markdown学习笔记

markdown的目标是实现易读易写,成为一种适用于网络的书写语言
用Markdown格式写文本,通过支持markdown格式的浏览器或编辑器,就可以按相应的格式显示。

2.markdown常用语法规则

2.1标题

# 标题一
## 标题二
### 标题三    

以此类推直到标题六

2.2引用

如果你需要引用一段文字,就需要用到引用格式

显示效果:

引用文字(要注意符号和文本间的空格)

只需要在引用文本前添加>这种尖括号即可

2.2.1引用嵌套

区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的>

> 第一层引用
>
> > 第二层引用
>
> 返回到第一层

显示效果:

第一层引用

第二层引用

返回到第一层

2.2.2引用其他要素

引用的区块内也可以使用其他的markdown语法,包括标题、列表、代码区块:

> ## 这是一个标题
>
> 1. 第一行列表项
> 2. 第二行列表项
>

显示效果:

这是一个标题

  1. 第一行列表项
  2. 第二行列表项

2.3列表

2.3.1无序列表

无序列表使用星号*、加号+或减号-作为列表标记(每个符号与文字间要有一个空格活制表符)

*    Red
+    Green
-    Blue

* Red 等同于 + Red 等同于 - Red

2.3.2有序列表

有序列表直接在文字前加1.``2.``3.序号

1.  Red
2.  Green
3.  Blue 

2.3.3包含段落的列表

列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符:

1.    我要一步一步往上爬  等待阳光静静看着它的脸
      (注意要空一行)
      小小的天有大大的梦想  重重的壳裹着轻轻地仰望 
2.    我要一步一步往上爬  在最高点乘着叶片往前飞

      小小的天流过的泪和汗  总有一天我有属于我的天

显示效果:

  1. 我要一步一步往上爬 等待阳光静静看着它的脸

    小小的天有大大的梦想 重重的壳裹着轻轻地仰望

  2. 我要一步一步往上爬 在最高点乘着叶片往前飞

    小小的天流过的泪和汗 总有一天我有属于我的天

2.3.4包含引用的列表

如果要在列表项目内放进引用,那>就需要缩进:

*    下面是引用文字
    (注意要空一行)
    > 引用文字

显示效果:

  • 下面是引用文字

    引用文字

2.3.5包含代码区块的列表

如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:

*    一列表项包含一个列表区块

        <代码写在这里>

显示效果:

  • 一列表项包含一个代码区块

    function mycode(){

    return a+b;
    

    }

2.3.6一个特殊情况

当然,项目列表很可能会不小心产生,像是下面这样的写法:

1986. What a great season.

显示效果:

  1. What a great season.

如果行首出现数字——句点——空白,要避免这样的情况,需要在句点前加入

1986. What a great season.

显示效果:

1986. What a great season.

2.4代码

2.4.1行内代码

即插入一个单词或一句代码的情况,使用`code`这样的形式插入

2.4.2多行代码

要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以:

这是一个普通段落

    function mycode(){
        return a+b;
    }

显示效果:
这是一个普通段落

function mycode(){
    return a+b;
}

2.5分割线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:

* * *

***

*******

- - -

——————————————————————

显示效果:






2.6超链接

2.6.1行内式

链接文字都是用 [方括号] 来标记,在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的title文字,只要在网址后面(注意有空格),用双引号把 title 文字包起来即可:

欢迎来到[miki的博客](https://mikiMing.github.io)

欢迎来到[miki的博客](https://mikiMing.github.io "miki的github博客")

显示效果:

欢迎来到miki的博客

欢迎来到miki的博客

2.6.2参考式

参考式链接的写法分两步:
文中写[链接文字][id],在文本的任意位置添加[id]:链接地址 "title"

我经常逛[掘金][1]、[简书][2]。

[1]:https://gold.xitu.io/ "掘金"
[2]:http://www.jianshu.com/ "简书"

显示效果:

我经常逛掘金简书

2.6.3自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来,Markdown就会自动把它转成链接。一般网址的链接文字就和链接地址一样:

<https://www.baidu.com/>

<[email protected]>

显示效果:

https://www.baidu.com/

[email protected]

2.7图片

2.7.1行内式

![alt](url)
![alt](url "title")

显示效果:

夜华素素大婚

2.7.2参考式

![alt][id]

[id]:url "title"

到目前为止,Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 <img>标签。

2.8强调

Markdown使用星号*和底线_作为标记强调字词的符号,被*_ 包围的字词会被转成用 <em> 标签包围,用两个*_ 包起来的话,则会被转成 <strong>

*强调句一*
_强调句二_
**强调句三**
__强调句四__

显示效果:

强调句一
强调句二
强调句三
强调句四