markdown基础语法
1.标题
标题格式:#+空格+标题内容,如# 标题
2.段落
用空白行创建段落,例如:
对泉能自诫,如镜静相邻。
最佳实践:
不要用空格或制表符(tabs)缩进段落。用 和全角空格缩进。
3.换行
两种方式,一种是在结尾处输入多个空格(>=2),然后按回车换行;另一种方式是用html标签</br>
实现换行。
4.强调
两种强调,一种是加粗,一种是斜体。
1)加粗
语法 **加粗内容** 或 __加粗内容__ ,即用两个星号或两个下划线将强调内容包起来。建议用两个星号(**),不建议用两个下划线(__)
2) 斜体
一个或一个_。
如果想 加粗且斜体,用三个*号包起来(号前面要有一个空格)。
This is really very important text.
5.引用
如果要引用,在段落前加一个>
符号。
这句话我没说! --鲁迅
要结束引用,需要另起一段(加一个空行)。
可以包含多个段落。在段落的空白行添加一个>
符号。
这句话我没说! --鲁迅
我说过。 --罗翔
引用可以嵌套。在要嵌套的段落 前添加一个>>
符号。
罗翔老师说过:
啤酒饮料矿泉水,瓜子香烟大碗茶。 --罗翔
块元素可以包含一部分其他markdown格式的元素,如**,###等。
6.列表
有序列表
要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。
注意:
1. 数字或-后要有一个空格,不然不识别
2. 创建子列表用四个空格
2. 列表最好另起一段(即用空行隔开)
- 标题
- 子列表1
- 子列表2
- 段落
无序列表
要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。
- 列表1
- 列表2
- 子列表1
- 子列表2
- 列表3
- 列表4
在列表中嵌套其他元素:
-
嵌套段落
要在保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格或一个制表符。 -
嵌套引用块
罗翔老师说过
-
嵌套代码块
代码块通常用四个空格或一个制表符缩进。当它们被放在列表中时,请将它们缩进8个空格或2个制表符。<html> <head> <title>Test</title> </head> </html>
-
嵌套图片
-
嵌套列表
- abc
- cde
7.代码
反引号
要将单词或短语表示为代码,请将其包裹在反引号(`
)中。
注意:如果包裹的内容开始时有一个空格,对称的结束时也要有一个空格。
Markdown语法 | HTML | 预览效果 |
---|---|---|
At the command promtp,type `nano` . |
At the command promtp,type<code>nano</code>. |
At the command promtp,type nano . |
转义反引号
如果代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在反双引号( ``
)中。
Markdown语法 | HTML | 预览效果 |
---|---|---|
``Use `code` in your Markdown file.`` |
<code> Use `code` in your Markdown file.</code> |
Use `code ` in your Markdown file. |
代码块
要创建代码块,2种方法:
-
将代码块的每一行缩进至少四个空格或一个制表符。
<html> <head> <title>test</tile> </head> </html>
-
如果不用缩进的代码块,请使用
围栏式代码块
。
围栏代码块是用三个反引号(```)或三个波浪符号(~~~)。
围栏代码块可以指定代码的类型(在第一个```后+空格+代码类型),如下代码类型指定为html:<html> <head> <title>test</tile> </head> </html>
8.分隔线
要创建分隔线,在单独一行上使用至少三个星号(***)或至少三个破折号(---)或至少三个下划线(___),并且不能包含其他内容。
***
---
——————
最佳实践:
为了兼容性,请在分隔线的前后均添加空白行。
----
9.链接
示例如下:
这是一个链接 **[Markdown语法](https://markdown.com.cn "最好的markdown教程")**。
效果:
这是一个链接 Markdown语法。
其中,
- 方括号中是链接描述,圆括号中是链接url和链接title。
最好的markdown教程
是可选的title,用于显示鼠标悬浮在链接上浮动框中的文字。- 可以给链接加格式,如加粗、斜体、可以把方括号中的链接描述设置为显示为代码等。
使用尖括号可以方便的把URL或者email地址变成可点击的链接:
<https://markdown.com.cn>
<[email protected]>
效果如下:
https://markdown.com.cn
[email protected]
引用类型链接(锚点)
引用样式链接是一种特殊的链接,它使URL在Markdown中更易于显示和阅读。
例一
语法:[描述](#id)
例子:
<h3 id=_link_click_group>触发点 </h3>
[点击跳到链接一](#_link_1st)、[点击跳到链接二](#_link_2nd)、[点击跳到链接三](#_link_3rd)、脚注[^1]
<a id=_link_1st>链接一</a>([回到触发点](#_link_click_group))
<a id=_link_2nd>链接二</a>([回到触发点](#_link_click_group))
<span id=_link_3rd>链接三</span>([回到触发点](#_link_click_group))
[1]: 我是注脚
效果:
触发点
点击跳到链接一、点击跳到链接二、点击跳到链接三、
生成一个脚注1[1]
链接一(回到触发点)
链接二(回到触发点)
链接三(回到触发点)
例二
作为变量。变量的值不会显示在页面上。
这个链接用 3 作为网址变量 [Google][3]
这个链接用 runoob 作为网址变量 [Runoob][runoob]
然后在文档的结尾为变量赋值(网址)
[3]: http://www.google.com/
[runoob]: http://www.runoob.com/
效果:
这个链接用 3 作为网址变量 Baidu
这个链接用 runoob 作为网址变量 Runoob
然后在文档的结尾为变量赋值(网址)
10.链接
要添加图像,请使用感叹号 (!), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。
插入图片Markdown语法代码:![图片alt](图片链接 "图片title")
。
对应的HTML代码:<img src="图片链接" alt="图片alt" title="图片title">
11.转义字符
要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符\
。
\* Without the backslash, this would be a bullet in an unordered list.
渲染效果如下:
* Without the backslash, this would be a bullet in an unordered list.
12.内嵌HTML标签
对于 Markdown 涵盖范围之外的标签,都可以直接在文件里面用 HTML 本身。如需使用 HTML,不需要额外标注这是 HTML 或是 Markdown,只需 HTML 标签添加到 Markdown 文本中即可。
HTML 用法最佳实践:
出于安全原因,并非所有 Markdown 应用程序都支持在 Markdown 文档中添加 HTML。如有疑问,请查看相应 Markdown 应用程序的手册。某些应用程序只支持 HTML 标签的子集。
对于 HTML 的块级元素 <div>、<table>、<pre> 和 <p>,请在其前后使用空行(blank lines)与其它内容进行分隔。尽量不要使用制表符(tabs)或空格(spaces)对 HTML 标签做缩进,否则将影响格式。
在 HTML 块级标签内不能使用 Markdown 语法。例如 <p>italic and **bold**</p> 将不起作用。
这是脚注的内容 ↩︎