markdown语法简述&ai_agent
markdown
恭喜markdown成为世界上最好的语言(bushi)
简述一下markdown的语法
markdown 标题
要创建标题,请在单词或短语前面添加井号 (#) 。# 的数量代表了标题的级别。例如,添加三个 # 表示创建一个三级标题 (<h3>)
例如:### My Header
Markdown 段落
markdown的分段和正常的不一样,他需要额外空出一段才是分段1
2
3I really like using Markdown.
I think I'll use it to format all of my documents from now on.
对应的是html的1
2
3<p>I really like using Markdown.</p>
<p>I think I'll use it to format all of my documents from now on.</p>
Markdown 换行
在一行的末尾加上两个或者多个空格,然后按回车,就可以创建一个<br>
(实际上,在编译器中很少能看见两个空格或者多个空格,并且多数人都会下意识的添加两个空格,所以我更建议你采用<br>的格式,再不济令起一个段落也是可以的)
Markdown 强调
fleet里面*是表示加强,_是表示倾斜,其他的markdown编译器可能是两个*强调一个*倾斜
Markdown 引用
要创建块引用,请在段落前添加一个 > 符号
Dorothy followed her through many of the beautiful rooms in her castle.
多个的话就直接在每一段前面以及中间的空白行之间添加>就行
Dorothy followed her through many of the beautiful rooms in her castle.
The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
嵌套块引用
块引用可以嵌套。在要嵌套的段落前添加一个 >> 符号
Dorothy followed her through many of the beautiful rooms in her castle.
The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
块引用可以包含其他 Markdown格式的元素。
并非所有元素都可以使用,你需要进行实验以查看哪些元素有效。
The quarterly results look great!
- Revenue was off the chart.
Profits were higher than ever.
Everything is going according to plan.
Markdown 列表
有序的话就是1.2.3.这种,比如说
- hello
- world
无序的话则是——的形式,qishi *,+也都可以
- hello
- world
- hello(*)
- world(+)
要在保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格或一个制表符,如下例所示
- This is the first list item.
Here’s the second list item.
I need to add another paragraph below the second list item.
And here’s the third list item.
中间插入图片,代码段什么的也都可以,格式也是缩进四个空格或一个制表符
Markdown 代码
三个转义反引号
Markdown 分隔线
要创建分隔线,请在单独一行上使用三个或多个星号 (*)、破折号 (—-) 或下划线 (_) ,并且不能包含其他内容
Markdown 链接
基操
链接文本放在中括号内,链接地址放在后面的括号中,链接title可选。
超链接Markdown语法代码:[超链接显示名](超链接地址 "超链接title")
对应的HTML代码:<a href="超链接地址" title="超链接title">超链接显示名</a>
给链接加title
链接title是当鼠标悬停在链接上时会出现的文字,这个title是可选的,它放在圆括号中链接地址后面,跟链接地址之间以空格分隔
这是一个链接 [Markdown语法](https://markdown.com.cn "最好的markdown教程")。
渲染效果如下
这是一个链接 Markdown语法。
网址和Email地址
使用尖括号可以很方便地把URL或者email地址变成可点击的链接<https://markdown.com.cn>
带格式化的链接
强调链接, 在链接语法前后增加星号。 要将链接表示为代码,请在方括号中添加反引号
1 | I love supporting the **[EFF](https://eff.org)**. |
I love supporting the EFF.
This is the Markdown Guide.
See the section on code.
引用类型链接
第一部分格式
引用类型的链接的第一部分使用两组括号进行格式设置。第一组方括号包围应显示为链接的文本。第二组括号显示了一个标签,该标签用于指向您存储在文档其他位置的链接。
1 | [hobbit-hole][1] |
第二部分格式
引用类型链接的第二部分使用以下属性设置格式:
- 放在括号中的标签,其后紧跟一个冒号和至少一个空格(例如
[label]:)。 - 链接的URL,可以选择将其括在尖括号中。
- 链接的可选标题,可以将其括在双引号,单引号或括号中
可以将链接的第二部分放在Markdown文档中的任何位置。有些人将它们放在出现的段落之后,有些人则将它们放在文档的末尾
1 | [1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle |
Markdown 图片
要添加图像,请使用感叹号 (!), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。
插入图片Markdown语法代码:。
对应的HTML代码:<img src="图片链接" alt="图片alt" title="图片title">
Markdown 转义字符
特殊字符自动专业,在 HTML 文件中,有两个字符需要特殊处理: < 和 & 。 < 符号用于起始标签,& 符号则用于标记 HTML 实体,如果你只是想要使用这些符号,你必须要使用实体的形式,像是 < 和 &。
& 符号其实很容易让写作网页文件的人感到困扰,如果你要打「AT&T」 ,你必须要写成「AT&T」 ,还得转换网址内的 & 符号1
http://images.google.com/images?num=30&q=larry+bird
你必须改成1
http://images.google.com/images?num=30&q=larry+bird
才能放到链接标签的 href 属性里。不用说也知道这很容易忘记,这也可能是 HTML 标准检查所检查到的错误中,数量最多的。
Markdown 允许你直接使用这些符号,它帮你自动转义字符。如果你使用 & 符号的作为 HTML 实体的一部分,那么它不会被转换,而在其它情况下,它则会被转换成 &。
所以你如果要在文件中插入一个著作权的符号,你可以这样写:©,Markdown 将不会对这段文字做修改,但是如果你这样写AT&T,Markdown 就会将它转为:AT&T,(但是我在fleet中测试却是不会,奇了怪了)
Markdown 内嵌 HTML 标签
对于 Markdown 涵盖范围之外的标签,都可以直接在文件里面用 HTML 本身。如需使用 HTML,不需要额外标注这是 HTML 或是 Markdown,只需 HTML 标签添加到 Markdown 文本中即可。
比如This **word** is bold. This <em>word</em> is italic.
可以被解析为
This word is bold. This word is italic.
区块元素──比如<div>、<table>、<pre>、<p> 等标签,必须在前后加上空行,以便于内容区分。而且这些元素的开始与结尾标签,不可以用 tab 或是空白来缩进。Markdown 会自动识别这区块元素,避免在区块标签前后加上没有必要的 <p> 标签
1 | This is a regular paragraph. |
会被解析为
This is a regular paragraph.
| Foo |
This is another regular paragraph.




