markdown 语法简单总结

Posted xiaoshuai666

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了markdown 语法简单总结相关的知识,希望对你有一定的参考价值。

  1. 知识点简单总结
  2. 效果演示



知识点

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 "腾讯图标"

技术分享图片
技术分享图片





















以上是关于markdown 语法简单总结的主要内容,如果未能解决你的问题,请参考以下文章

Markdown简单语法总结

Markdown基本语法总结

Markdown常用语法(个人总结)

Markdown使用总结

为啥程序员都应该用 Markdown?怎么用才更高效

VS Code配置markdown代码片段