声明
以下所有内容均参考自 Markdown官方教程
想查询具体语法,可点击右侧 Markdown语法速查表
若本文与教程存在冲突,以官方教程为准。本文实践平台为掘金社区的Markdown文本编辑器。
最近开始学习用Markdown编辑文本,讲这些记录下来,以来可巩固用法,二来可供以后随时查看。
标题
在标题文字前加上#和一个空格即可。一个#代表一级标题,两个#则代表二级标题,最多可有六级标题。
新增段落
段落之间空行即可。
换行
只需要在末尾添加两个或者多个空格再回车即可。
或者加上HTML中的< br >也可以换行。
符号内不要空格,否则换行不成功。
加粗
要加粗文本,请在单词或短语的前后各添加两个星号或 下划线.如需加粗一个单词或短语的中间部分用以表示强调的话,请在要加粗部分的两侧各添加两个星号。需要注意的是,下划线 前和后,需要用空格或者符号与汉字进行分隔,否则加粗可能不会生效。使用星号的兼容性更高,推荐使用星号*!
斜体
在文本前后添加一个星号或一段下划线。要斜体突出单词的中间部分,请在字符前后各添加一个星号,中间不要带空格,带空格会使倾斜失效。下划线只支持使整个单词倾斜,不支持使单词中某些字母倾斜。因此也是星号的兼容性更好。
同时倾斜、加粗
同时用粗体和斜体突出显示文本,方法有四种:
- 文本前后加上三个星号*。
- 文本前后加上三个下划线。
- 文本前后加上两个下划线和一个星号。
- 文本前后加上两个星号和一个下划线。 但是,如果需要给单词内的字母加上样式,只能使用三个星号。同时三个星号的兼容性也是最好的,推荐使用三个星号来添加样式。如果存在样式不生效的情况,首先检查在星号之前加一个空格或者标点符号之后是否可以生效。
引用
引用用大于号>,需要另起一行。多段引用需要在段落之间的空行上也加上大于号>.
倘只看书,便变成书橱。——鲁迅
其实地上本没有路,走的人多了,也便成了路。——鲁迅
学而不思则罔 思而不学则殆. ——《论语》
引用内可以再引用,再加一个大于号即可。
他翻开了桌上的笔记本,最新的一页上面记着:
倘只看书,便变成书橱。——鲁迅
引用块内可以包含其他Markdown格式的元素。但不是所有的都可以使用,需要验证哪些元素有效。标题、无序列表、粗体、斜体等都可生效。
列表
有序列表
在每个列表项前添加数字并紧跟一个英文句号,英文句号后需要加空格才能生效。数字不必按数学顺序排列,但是列表应当以数字 1 起始,展示效果时会自动按照顺序排序。空三个以上,可创建嵌套列表。
在部分编辑器下,可以用反括号来完成有序列表,但是不推荐,兼容性不好。
以下是几部鲁迅先生一些作品:
- 小说集
- 《呐喊》
- 《彷徨》
- 《故事新编》等
- 散文集《朝花夕拾》
- 散文诗集《野草》
- 杂文集
- 《坟》
- 《热风》
- 《华盖集》
- 《华盖集续编》
- 《南腔北调集》
- 《三闲集》
- 《二心集》
- 《而已集》
- 《且介亭杂文》等。
无序列表
创建无序列表,在每个列表项前面添加短横线 -、星号* 或加号 + ,然后空格再接内容。缩进多个空格可创建嵌套列表(亲测需要2个及以上)。
《红楼梦》四大家族及部分人物:
- 贾家
- 贾宝玉
- 史家
- 史湘云
- 王家
- 王熙凤
- 薛家
- 薛宝钗
虽然有的平台支持同时使用不同的符号(掘金平台支持),但是比较保险的方式还是使用同一种符号。
要在保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格或一个制表符。代码块通常采用四个空格或一个制表符缩进。因此当它们被放在列表中时,需要在原来的基础上再缩进四个空格或一个制表符,即缩进八个空格或两个制表符。
有序列表和无需列表可以相互嵌套。
代码语法
将代码包裹在反引号中(反引号在键盘上tab键上方,数字1键左边)。如果代码中已经存在反引号了,外面就用双反引号。个人觉得全部都有双反引号更加保险。
hello world
hello world
将代码的每一行缩进至少四个空格或一个制表符来创建代码块,不用反引号来标识了。
hello world
hello world
hello world
如果想将代码高亮,在代码前一行加上```和语言名称即可。代码结束也需再加上```。
<!DOCTYPE html> <html lang="zh-CN">
<head> <meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>我的网页</title>
</head>
<body>
content
</body>
</html>
分隔线
单独一行上使用三个或多个星号、破折号 (---) 或下划线 ,并且不能包含其他内容。为了兼容性更好,建议分隔线上下都空一行,不会影响排版。
↑是分隔线
↓也是分隔线
超链接
增加超链接的格式为:[显示的文本](链接 '悬浮的title')
如果链接中存在空格,尽管能够支持,但是保险起见,还是用 %20代替空格 更好。
如果需要给超链接增加一个悬浮的title说明,可以放在圆括号中链接地址后面,跟链接地址之间以空格分隔,并用引号包起来。
如果想把把URL或者email地址变成可点击的网址,用尖括号括起来即可。
插入图片
插入图片语法:感叹号加方括号内填图片名,紧跟一个小括号,填写图片链接,链接后同样支持空一格增加一个悬浮title,title需要用引号包裹。
需要使图片可点击跳转,先把插入图片的语句用方括号包起来,再紧跟一个小括号,内填入地址即可。
比如你可以点击下面的图片,进入我的主页
显示转义字符
如果想要显示具有语法意义的字符,例如*等,可在符号之前加上\。
以上就是最常用的一些Markdown的语法了~
想了解更多扩展语法可参考:Markdown扩展语法