1.认识markdown
markdown的目标是实现易读易写,成为一种适用于网络的书写语言
用Markdown格式写文本,通过支持markdown格式的浏览器或编辑器,就可以按相应的格式显示。
2.markdown常用语法规则
2.1标题
# 标题一
## 标题二
### 标题三
以此类推直到标题六
2.2引用
如果你需要引用一段文字,就需要用到引用格式
显示效果:
引用文字(要注意符号和文本间的空格)
只需要在引用文本前添加>
这种尖括号即可
2.2.1引用嵌套
区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的>
:
> 第一层引用
>
> > 第二层引用
>
> 返回到第一层
显示效果:
第一层引用
第二层引用
返回到第一层
2.2.2引用其他要素
引用的区块内也可以使用其他的markdown语法,包括标题、列表、代码区块:
> ## 这是一个标题
>
> 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. 我要一步一步往上爬 在最高点乘着叶片往前飞
小小的天流过的泪和汗 总有一天我有属于我的天
显示效果:
我要一步一步往上爬 等待阳光静静看着它的脸
小小的天有大大的梦想 重重的壳裹着轻轻地仰望
我要一步一步往上爬 在最高点乘着叶片往前飞
小小的天流过的泪和汗 总有一天我有属于我的天
2.3.4包含引用的列表
如果要在列表项目内放进引用,那>
就需要缩进:
* 下面是引用文字
(注意要空一行)
> 引用文字
显示效果:
下面是引用文字
引用文字
2.3.5包含代码区块的列表
如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:
* 一列表项包含一个列表区块
<代码写在这里>
显示效果:
一列表项包含一个代码区块
function mycode(){
return a+b;
}
2.3.6一个特殊情况
当然,项目列表很可能会不小心产生,像是下面这样的写法:
1986. What a great season.
显示效果:
- 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/>
<address@example.com>
显示效果:
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>
:
*强调句一*
_强调句二_
**强调句三**
__强调句四__
显示效果:
强调句一
强调句二
强调句三
强调句四