day1. Markdown语法

标题语法

不同的'#'数量用来完成不同标题。
为了兼容性,请用一个空格在'#'和标题之间进行分隔。
在文本下方添加任意数量的 == 号来标识一级标题,或者 -- 号来标识二级标题。

段落语法

要创建段落,请使用空白行将一行或多行文本进行分隔。
不要用空格(spaces)或制表符( tabs)缩进段落。

换行语法

在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行。
为了兼容性,请在行尾添加“结尾空格”或 HTML 的<br>标签来实现换行。
至少有两种轻量级标记语言支持键入回车键(return)实现换行。

强调语法

粗体(Bold):在单词或短语的前后各添加两个星号(asterisks)(或下划线underscores用于单词或短语的中间部分)。
斜体(Italic):在单词或短语前后添加一个星号(asterisk)或下划线(underscore)。
粗体(Bold)和斜体(Italic):在单词或短语的前后各添加三个星号(或下划线用于单词或短语的中间部分),中间不要带空格。

引用语法

一个段落的块引用:在段落前添加一个 > 符号。
多个段落的块引用:为段落之间的空白行添加一个 > 符号。
嵌套块引用:在要嵌套的段落前添加一个 >> 符号。
带有其它元素的块引用:块引用可以包含其他 Markdown 格式的元素。并非所有元素都可以使用,需要进行实验以查看哪些元素有效。

列表语法

有序列表:在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。
无序列表:在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。
在列表中嵌套其他元素:要在保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格一个制表符
引用块:采用四个空格或一个制表符缩进后,加引用符号>
代码块:采用四个空格一个制表符缩进。当它们被放在列表中时,请将它们缩进八个空格两个制表符
图片:采用四个空格或一个制表符缩进后,语法为:
![Tux, the Linux mascot](/assets/images/tux.png)

代码语法

代码:要将单词或短语表示为代码,请将其包裹在反引号 (`) 中。
代码中包含反引号:如果你要表示为代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号(``)中。
围栏代码块:在代码块之前和之后的行上使用三个反引号((```)或三个波浪号(~~~)。
添加语法突出显示:在受防护的代码块之前的反引号旁边指定一种语言。

"hello world"

分隔线语法

在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ,并且不能包含其他内容。
为了兼容性,请在分隔线的前后均添加空白行。

链接语法

链接:链接文本放在中括号内,链接地址放在后面的括号中,链接title可选。
超链接
[超链接显示名](超链接地址 "超链接title")
给链接增加 Title:链接title是当鼠标悬停在链接上时会出现的文字,这个title是可选的,它放在圆括号中链接地址后面,跟链接地址之间以空格分隔。
这是一个链接 [Markdown语法](https://markdown.com.cn "最好的markdown教程")。(https://markdown.com.cn "最好的markdown教程")。
网址和Email地址:使用尖括号可以很方便地把URL或者email地址变成可点击的链接。<https://markdown.com.cn> <fake@example.com>
带格式化的链接:在链接语法前后增加星号。
将链接表示为代码:在方括号中添加反引号。
引用类型链接:参考样式链接分为两部分:与文本保持内联的部分以及存储在文件中其他位置的部分,以使文本易于阅读。

  • 引用类型的链接的第一部分:使用两组括号进行格式设置。第一组方括号包围应显示为链接的文本。第二组括号显示了一个标签,该标签用于指向您存储在文档其他位置的链接。
    尽管不是必需的,可以在第一组和第二组括号之间包含一个空格。第二组括号中的标签不区分大小写,可以包含字母,数字,空格或标点符号。
  • 引用类型链接的第二部分:放在括号中的标签,其后紧跟一个冒号和至少一个空格(例如[label]:)。
    链接的URL,可以选择将其括在尖括号中。链接的可选标题,可以将其括在双引号,单引号或括号中。
    可以将链接的第二部分放在Markdown文档中的任何位置。有些人将它们放在出现的段落之后,有些人则将它们放在文档的末尾(例如尾注或脚注)。

图片语法

添加图像:用感叹号 (!), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。
插入图片[图片上传失败...(image-e4319b-1627008305585)]
对应的HTML代码<img src="图片链接" alt="图片alt" title="图片title">
链接图片:将图像的Markdown 括在方括号中,然后将链接添加在圆括号中。
[[图片上传失败...(image-d5d132-1627008305585)]](https://markdown.com.cn)

转义字符语法

要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符 () 。
可做转义的字符
\ ` * _ { } [ ] ( ) # + - . ! |
特殊字符自动转义
在 HTML 文件中,有两个字符需要特殊处理: < 和 & 。 < 符号用于起始标签,& 符号则用于标记 HTML 实体,如果你只是想要使用这些符号,你必须要使用实体的形式,像是 < 和 &。
& 符号其实很容易让写作网页文件的人感到困扰,如果你要打「AT&T」 ,你必须要写成「AT&T」 ,还得转换网址内的 & 符号,如果你要链接到:http://images.google.com/images?num=30&q=larry+bird,必须要把网址转成:http://images.google.com/images?num=30&amp;q=larry+bird,才能放到链接标签的 href 属性里。
Markdown 允许你直接使用这些符号,它帮你自动转义字符。如果你使用 & 符号的作为 HTML 实体的一部分,那么它不会被转换,而在其它情况下,它则会被转换成 &。

需要特别注意的是,在 Markdown 的块级元素和内联元素中, < 和 & 两个符号都会被自动转换成 HTML 实体,这项特性让你可以很容易地用 Markdown 写 HTML。(在 HTML 语法中,你要手动把所有的 < 和 & 都转换为 HTML 实体。)

来源:Markdown 内嵌 HTML 标签 | Markdown 语法教程

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,214评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,307评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,543评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,221评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,224评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,007评论 1 284
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,313评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,956评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,441评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,925评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,018评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,685评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,234评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,240评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,464评论 1 261
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,467评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,762评论 2 345

推荐阅读更多精彩内容