markdown 语法简单总结

Posted 2021-01-25 xiaoshuai666

1. 知识点简单总结
   • 1.标题
   • 2.引用
   • 3.列表
   • 4.代码
   • 5.分割线
   • 6.链接
   • 7.强调
   • 8.图片
2. 效果演示
   • 1.标题演示
   • 2.引用演示
   • 3.列表演示
   • 4.代码演示
   • 5.分割线演示
   • 6.链接演示
   • 7.强调演示
   • 8.图片演示

---

---

---

知识点

1. 标题

两种语法

1. 在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶
2. 利用=和-，以底线的形式表示标题

注意点

1. 标题只有6级
2. 标题的#后面有没有空格都一样
3. 使用=和-表示的标题只有最高和第二高阶
4. =和-表示标题时可以使用任何数量

2.引用

语法

使用> 符号表示引用

注意点

1. 引用可只在第一行加一个>符号， 直到遇到一个空行表示段落结束
2. 引用可以嵌套, 一个> 表示一层
3. 引用内的代码也可以使用其他的markdown语法，比如标题、列表、代码块等

3.列表

语法

1. 使用星号，加号，减号表示无序列表
2. 使用数字加一个英文句号表示有序列表

注意点

1. 标记后面一定要跟一个空格或者制表符
2. 有序列表使用的数字不影响最终的输出结果（即时输入的是1. 1. 1. 的列表，展示时还是展示1. 2. 3.）
3. 列表标记通常在最左边，最多可以缩进3个空格
4. 列表之间的空行不影响列表的展示
5. 在列表项目内放进引用，那 > 就需要缩进
6. 要避免在行首出现数字+句点+空白，这会被当做列表，可以用转义句点
7. 列表第一个数字会被作为列表的起始数字
8. 在列表项目内要放代码区块的话，该区块就需要缩进两次，也就是 8 个空格或是 2 个制表符（一般的代码区块只需要一个tab或者4个空格）

4.代码

语法

1. 缩进 4 个空格或是 1 个制表符就可以建立代码区块(制表符兼容性差)
2. 使用3个以上的反引号括起来的内容也是代码区块内容
3. 使用一个或者两个反引号括起来的内容是单行代码内容

注意点

1. 一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）
2. 可以直接在代码区块里写html代码, & 、 < 和 > 会自动转成 HTML 实体

5.分割线

语法

在一行中用三个以上的星号、减号、底线来建立一个分隔线

注意点

行内不能有除了空格外的其他东西

6.链接

语法

    行内式链接：[展示内容](url链接 "可选title")
    参考式链接使用：[展示内容]一个可选空格[标识id]
    参考式链接定义：[标识id]+:+一个以上空格或制表符+url链接+可选title(可以用单引号,双引号,圆括号括起来)

自动链接：只要是用方括号包起来， Markdown 就会自动把它转成链接

注意点

1. 链接网址也可以用方括号包起来
2. 可以把 title 属性放到下一行，也可以加一些缩进，若网址太长的话，这样会比较好看
3. 网址定义只有在产生链接的时候用到，并不会直接出现在文件之中
4. 链接辨别标签（标识id）可以有字母、数字、空白和标点符号，但是并不区分大小写
5. 隐式链接标记功能让你可以省略指定链接标记，这种情形下，链接标记会视为等同于链接文字,要用隐式链接标记只要在链接文字后面加上一个空的方括号
6. 链接的定义可以放在文件中的任何一个地方
7. 参考式的链接其实重点不在于它比较好写，而是它比较好读.使用 Markdown 的参考式链接，可以让文件更像是浏览器最后产生的结果，让你可以把一些标记相关的元数据移到段落文字之外
8. 多个连接时，先定义的连接有效

7.强调

语法

1. 一个*或者_表示斜体
2. 两个*或者_表示斜体

注意点

1. 用什么符号开启标签，就要用什么符号结束
2. 如果* 和 _ 两边都有空白的话，它们就只会被当成普通的符号
3. 要在文字前后直接插入普通的星号或底线，可以用反斜线

8.图片

语法

     1. 行内式：![图片替代文本](url "可选的title")
     2. 参考式使用：![图片替代文本][id]

参考式定义：[标识id]+:+一个以上空格或制表符+url链接+可选title(可以用单引号,双引号,圆括号括起来)

注意点

1. 插入图片和语法和链接语法相似，只是多了一个!
2. 到目前为止， Markdown 还没有办法指定图片的宽高

---

---

---

简单演示

1.标题演示效果

# 一级标题
...
###### 六级标题
######(标题的#后面)有没有空格都一样
####### 标题只有6级
一级标题
=
二级标题
-

一级标题

...

六级标题

(标题的#后面)有没有空格都一样

标题只有6级

一级标题

二级标题

2. 引用演示效果

> 第一行,
第二行
。。。

> 引用可以嵌套
> > 两层嵌套
> > > 三层嵌套
> ######标题
> 1. 列表1
> 2. 列表2

第一行,
第二行
。。。

引用可以嵌套

两层嵌套

三层嵌套

标题

1. 列表1
2. 列表2

3. 列表演示效果

* 无序列表*1
* 无序列表*2
+ 无序列表+1
+ 无序列表+2
- 无序列表-1
- 无序列表-2

- 空行无影响
4. 列表第一个数字被当做有序列表的起始数字
1.  引用需要缩进
1.  > 缩进
1. 引用需要缩进
> 没有缩进
1. 有序列表被重置
2. 列表被重置
3.       8个空格后的内容自动放到代码区块中

• 无序列表*1
• 无序列表*2
• 无序列表+1
• 无序列表+2
• 无序列表-1

• 无序列表-2

• 空行无影响

1. 列表第一个数字被当做有序列表的起始数字
2. 引用需要缩进

3. 缩进

4. 引用需要缩进

   没有缩进

5. 有序列表被重置
6. 列表被重置

7.   8个空格后的内容自动放到代码区块中

4. 代码演示效果

    空格产生的代码区块
    回车产生的代码区块

    空行不会分割代码区块
``
这是单行代码
两个反引号括起来的单行代码可以插入单个`反`引`号`
``

空格产生的代码区块
回车产生的代码区块

空行不会分割代码区块

这是单行代码echo "hello world"

这是单行代码 两个反引号括起来的单行代码可以插入单个`反`引`号`

3个以上反引号括起来的代码和空格产生的代码区块效果一样

5. 分割线演示效果

不受空格影响的分割线（博客园不支持-_-！）
***
---
___
* *  *   *
- --- --
_ _ _ _
被其他字符污染了的没有效果的字符串
_ _ _ _a

不受空格影响的分割线（博客园不支持-_-！）
***
---
___
* * * *
- --- --
_ _ _ _
被其他字符污染了的没有效果的字符串

_ _ _ _a

6. 链接演示效果

[百度](http://baidu.com "百度一下")
[谷歌1][baidu]
[谷歌2][baidu]
[谷歌3][baidu]

匿名链接
[baidu][]

自动链接：<http://baidu.com>

[baidu]: http://baidu.com "看具体实现，我用atom是先定义的链接有效"
[baidu]: http://baidu.com "后定义的连接"

百度
谷歌1
谷歌2
谷歌3

匿名链接
baidu

自动链接：http://baidu.com

7. 强调演示效果

*斜体*
_斜体_
**加粗**
__加粗__
__混用无效**
_混用无效*

*以少的为主**

**以少的为主*

** 有空格无效**
**有空格无效 **

***号转义***

斜体
斜体
加粗
加粗
__混用无效**
_混用无效*

*atom以少的为主，博客园上无效**

**atom以少的为主，博客园上无效*

** 有空格无效
有空格无效 **

*号转义*

8. 图片演示效果

![图片无法访问](https://www.baidu.com/favicon.ico "百度图标")
![图片无法访问][img1]

[img1]: https://mat1.gtimg.com/www/icon/favicon2.ico "腾讯图标"