#Markdown基础语法

324 阅读6分钟
声明

以下所有内容均参考自 Markdown官方教程

想查询具体语法,可点击右侧 Markdown语法速查表

若本文与教程存在冲突,以官方教程为准。本文实践平台为掘金社区的Markdown文本编辑器。

最近开始学习用Markdown编辑文本,讲这些记录下来,以来可巩固用法,二来可供以后随时查看。

标题

在标题文字前加上#和一个空格即可。一个#代表一级标题,两个#则代表二级标题,最多可有六级标题。

新增段落

段落之间空行即可。

换行

只需要在末尾添加两个或者多个空格再回车即可。
或者加上HTML中的< br >也可以换行。
符号内不要空格,否则换行不成功。

加粗

要加粗文本,请在单词或短语的前后各添加两个星号下划线.如需加粗一个单词或短语的中间部分用以表示强调的话,请在要加粗部分的两侧各添加两个星号。需要注意的是,下划线 前和后,需要用空格或者符号与汉字进行分隔,否则加粗可能不会生效。使用星号的兼容性更高,推荐使用星号*!

斜体

在文本前后添加一个星号或一段下划线。要斜体突出单词的中间部分,请在字符前后各添加一个星号,中间不要带空格,带空格会使倾斜失效。下划线只支持使整个单词倾斜,不支持使单词中某些字母倾斜。因此也是星号的兼容性更好。

同时倾斜、加粗

同时用粗体和斜体突出显示文本,方法有四种:

  • 文本前后加上三个星号*。
  • 文本前后加上三个下划线。
  • 文本前后加上两个下划线和一个星号。
  • 文本前后加上两个星号和一个下划线。 但是,如果需要给单词内的字母加上样式,只能使用三个星号。同时三个星号的兼容性也是最好的,推荐使用三个星号来添加样式。如果存在样式不生效的情况,首先检查在星号之前加一个空格或者标点符号之后是否可以生效。
引用

引用用大于号>,需要另起一行。多段引用需要在段落之间的空行上也加上大于号>.

倘只看书,便变成书橱。——鲁迅

其实地上本没有路,走的人多了,也便成了路。——鲁迅

学而不思则罔 思而不学则殆. ——《论语》

引用内可以再引用,再加一个大于号即可。

他翻开了桌上的笔记本,最新的一页上面记着:

倘只看书,便变成书橱。——鲁迅

引用块内可以包含其他Markdown格式的元素。但不是所有的都可以使用,需要验证哪些元素有效。标题、无序列表、粗体、斜体等都可生效。

列表
有序列表

在每个列表项前添加数字并紧跟一个英文句号,英文句号后需要加空格才能生效。数字不必按数学顺序排列,但是列表应当以数字 1 起始,展示效果时会自动按照顺序排序。空三个以上,可创建嵌套列表。
在部分编辑器下,可以用反括号来完成有序列表,但是不推荐,兼容性不好。

以下是几部鲁迅先生一些作品:

  1. 小说集
    1. 《呐喊》
    2. 《彷徨》
    3. 《故事新编》等
  2. 散文集《朝花夕拾》
  3. 散文诗集《野草》
  4. 杂文集
    1. 《坟》
    2. 《热风》
    3. 《华盖集》
    4. 《华盖集续编》
    5. 《南腔北调集》
    6. 《三闲集》
    7. 《二心集》
    8. 《而已集》
    9. 《且介亭杂文》等。
无序列表

创建无序列表,在每个列表项前面添加短横线 -、星号* 或加号 + ,然后空格再接内容。缩进多个空格可创建嵌套列表(亲测需要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代替空格 更好。

示例图片1

如果需要给超链接增加一个悬浮的title说明,可以放在圆括号中链接地址后面,跟链接地址之间以空格分隔,并用引号包起来。

示例图片2

这是我的主页

如果想把把URL或者email地址变成可点击的网址,用尖括号括起来即可。

插入图片

插入图片语法:感叹号加方括号内填图片名,紧跟一个小括号,填写图片链接,链接后同样支持空一格增加一个悬浮title,title需要用引号包裹。

示例图片3

需要使图片可点击跳转,先把插入图片的语句用方括号包起来,再紧跟一个小括号,内填入地址即可。

示例图片4

比如你可以点击下面的图片,进入我的主页

示例图片5可跳我的主页

显示转义字符

如果想要显示具有语法意义的字符,例如*等,可在符号之前加上\。

以上就是最常用的一些Markdown的语法了~

想了解更多扩展语法可参考:Markdown扩展语法