转载请注明以下:
本文转自清自以敬的博客:https://blog.csdn.net/qq_45791147
本文只做个人使用时会用到的一些总结。
具体详细语法或规则等信息可见Markdown官网:http://www.markdown.cn/
1.Markdown和HTML
1.1.俩者关系
HTML是网页的发布格式,而Markdown是网页文本内容的书写格式,他对HTML中的标签进行了简化,就类似于以符号标识HTML元素,然后浏览器中解析为HTML发布。
所以markdown语法的符号都对应着HTML中的标签。
因为以符号标识了HTML元素,所以相比于HTML更易读、写、改。但由于只是网页文本内容的书写格式,所以只支持HTML中的部分标签。
1.2.HTML在Markdown中的移植
HTML块级元素移植:尽量保持元素前后存在空行(如table前后空行),同时块级元素标签体中的Markdown语法不会被生效,例如**
加粗。
HTML行内元素移植:如span、font这些,可直接写在段落内。且标签体中的markdown语法会生效。
2.Markdown符号语法
2.1.区块符号
- 下述块级符号本身就是HTML中块级元素的符号标识,具有独占一行的特性,因此前后有没有空行都一回事。
但是考虑到一些区块符号存在符号的嵌套(如blockquote会嵌套p)以及一些博客页面的兼容性(如表格),建议确保区块符号的前后具有一个空行。
这句话是针对整体(如列表就是个整体)元素而言的,而非其子项目(如列表项目)。
段落和插入换行:
以前后夹杂一行或以上空行
映射HTML段落标签p
,非常直观(空行的定义是显示上看起来像是空的。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。
段落之间也可以插入换行,则以>=2个的空格 + 换行
标识换行标签br
。(不建议连续换行,兼容性不强)
标题:h1~h6
→ 一个#
~6个#
。
引用:
以> + 一个空格
标识引用标签blockquote
。由于部分博客在引用中段落显示异常,所以建议以无序列表区分段落
列表:
无序ul:+
/-
/*
+ 空格
有序ol:数字
+ .
+ 空格
。无论数字多少都会被自动排序(第一个数字位基准) 。
- 列表项目中设置段落或者换行要注意和项目标记那一行的内容部分对齐。
列表项目中文本超过一行时,新行可缩进也可以不缩进,无所谓。- 如果需要列表嵌套,则子列表的列表标记要和上级的内容部分对齐
代码区块:
``` + 语言名 引出代码区块,内容要换行写(内容部分和```对齐),内容结束换行,然后以```结束。
但是区块中的markdown标记将无效,自然换行也就不用俩个空格 + 换行
了,直接enter即可换行。
表格:
例如:
|表头1|表头2|表头3|表头4|
|-|:-|-:|:-:|
|a|b|c|d|
呈现为:
表头1 | 表头2 | 表头3 | 表头4 |
---|---|---|---|
a | b | c | d |
分割线:
连续的三个*
、-
、_
都可以。
2.2.行内符号
链接和图片:
链接:
1, [链接名字](http://链接url)
。
2,[链接名字][]
,然后再任意位置(一般为文末)写:[链接名字]: + 空格 + http://链接
(写之前补上空行)。
- id名不区分大小写
- 如果要链接打开邮箱,则是mailto:邮箱
图片:在链接的前面加个!
即可,其他一样
简短超链接:<链接URL/邮箱>
行内代码:`代码内容`
加粗、加底线:**加粗内容**
、*加底线内容*
2.3.转义
转义就不多说了,反斜杠+特殊字符,不了解转义的移步至这条笔记。
来源:https://blog.csdn.net/qq_45791147/article/details/102718381