乐趣区

关于markdown:Markdown语法基础

jiezi

本文蕴含的 Markdown 语法有：

  • 题目
  • 文字
  • 粗斜体
  • 划线
  • 脚注
  • 段落
  • 换行
  • 分隔符
  • 列表
  • 区块援用
  • 代码
  • 链接
  • 图片
  • 表格
  • 目录
  • 正文
  • 反对的 HTML 元素
  • 转义字符

题目

在 Markdown 中题目能够应用两种形式来

  • 一种是用 =或-
  • 一种是用 #

1. 应用 = 或-

至多用三个 =或-

代码示例:

一级题目
===
二级题目
---

2. 应用#

在想要设置为题目的文字后面加 # 来示意

  • #前面要加空格
  • 一个 #是一级题目，二个# 是二级题目，以此类推。反对六级题目。

代码示例:

# 一级题目
## 二级题目
### 三级题目
#### 四级题目
##### 五级题目
###### 六级题目

文字

粗斜体

在 MarkDown 里，粗、斜体有两种写法，一种是用 *，一种是用 _ 包裹住你要扭转的内容

在 * 或 _ 与内容要紧贴着，之前不能用空格

  • 一个 * 或一个_ 是斜体
  • 两个 * 或两个_ 是粗体
  • 三个 * 或三个_ 是粗斜体

代码示例:

* 斜体文本 *          _斜体文本_
** 粗体文本 **        __粗体文本__
*** 粗斜体文本 ***    ___粗斜体文本___

示例成果:

斜体文本
粗体文本
粗斜体文本

划线

在 MarkDown 中没有上划线和下划线的本身语法，只有删除线 (中划线) 的语法，但能够通过其余形式实现

  • 上划线能够通过 Latex 公式实现
  • 删除线(中划线)
  • 下划线应用 HTML 语法或 Latex公式 实现

代码示例:

<!-- 通过 Latex 公式实现上划线 -->
$\overline{\text{上划线}}$

~~ 删除线~~

<!-- 通过 Latex 公式实现下划线 -->
$\underline{\text{下划线}}$

<!-- 通过 HTML 标签实现下划线 -->
<u> 下划线 </u>

示例成果:

<!– 通过 Latex 公式实现上划线 –>
$\overline{\text{上划线}}$

删除线

<!– 通过 Latex 公式实现下划线 –>
$\underline{\text{下划线}}$

<!– 通过 HTML 标签实现下划线 –>
<u> 下划线 </u>

脚注

在 MarkDown 中反对增加脚注形式来对文本进行补充阐明。

在须要增加注脚的文字后加上脚注名：1。而后在文本的任意地位 (个别在最初) 增加脚注：

脚注主动生成在页面最最前面，在页面开端能够看到，并且脚注前方的链接能够间接跳转回到加脚注的中央。

代码示例:

脚注示例，这是第一个脚注[^ 注脚名 1]，这是第二个脚注[^ 注脚名 2]，这是第三个脚注[^ 注脚名 3]
[^ 注脚名 1]: 我是脚注一.
[^ 注脚名 2]: 我是脚注二.
[^ 注脚名 3]: 我是脚注三.

示例成果:

脚注示例，这是第一个脚注2，这是第二个脚注3，这是第三个脚注4

段落

换行

在 Markdown 段落没有非凡的格局

  • 当须要内容换行时，应用两个以上空格加上回车。
  • 当须要生成新的段落，只需空出一行即可

多个空行只失效一个空行

代码示例:

上一行内容
下一行内容

上一个段落  

下一个段落

示例成果:

上一行内容
下一行内容

上一个段落

下一个段落

分隔符

在 Markdown 分隔符须要应用 * 或 - 或 _来建设

  • * 或 - 或 _都须要三个及其以上
  • * 或 - 或 _能够在两头插入空格，但不能在行内存在其余内容
  • * 或 - 或 _，以后后都有段落时，请空出一行

代码示例:


---

- - -

___

_ _ _

***

* * *

示例成果:

    • –

_

_

列表

无序列表

列表内容前可应用 * 或 - 或 + + 空格 来示意无序列表

代码示例:

- 无序列表项，应用 `-` + ` 空格 `
+ 无序列表项，应用 `+` + ` 空格 `
* 无序列表项，应用 `*` + ` 空格 `

示例成果:

  • 无序列表项，应用 - + 空格
  • 无序列表项，应用 + + 空格
  • 无序列表项，应用 * + 空格

有序列表

列表内容前可应用 数字 + 空格 来示意有序列表

有序列表会主动给你的列表项依照阿拉伯数字程序增加数字

代码示例:

1. 第一项
2. 第二项
4. 第三项

示例成果:

  1. 第一项
  2. 第二项
  3. 第三项

列表嵌套

子列表中的列表项前增加四个空格

代码示例:

1. 有序列表第一项 A
    - A 的第一项无序列表子项 a1
        1. a1 的第一项有序列表子项 a1a
        1. a1 的第二项有序列表子项 a1b
    - A 的第二项无序列表子项 a2
2. 有序列表第一项 B
    B 的第一行文本内容
    B 的第二行文本内容

示例成果:

  1. 有序列表第一项 A

    • A 的第一项无序列表子项 a1

      1. a1 的第一项有序列表子项 a1a
      2. a1 的第二项有序列表子项 a1b
    • A 的第二项无序列表子项 a2
  2. 有序列表第一项 B
    B 的第一行文本内容
    B 的第二行文本内容

区块援用

简略区块援用

在 Markdown 中应用 > + 空格 来示意区块援用

当须要换行时，能够在后方不加 >
须要新板块能够空出一行

代码示例:

> 换行能够不加 `>`
 我后面没有 `>`

> 如果须要新的一块，块援用则空出一行从新在文本后方应用 `>`

示例成果:

换行能够不加 >
我后面没有 >

如果须要新的一块，块援用则空出一行从新在文本后方应用 >

区块援用的嵌套

在 Markdown 中，区块援用也能够进行嵌套, 只需应用多个 >

嵌套区块援用应用 > 的个数，代表着嵌套的深度
嵌套区块援用中 > 之间能够不必空格隔开

代码示例:

>> 第二层

> 第一层
> > 第二层

> 第一层
> > > 第三层

示例成果:

第二层

第一层

第二层

第一层

第三层

区块援用与列表

在 Markdown 中，列表外面能够应用区块援用，区块援用中也能够应用列表

列表还能够嵌套列表，区块援用还能够嵌套区块(本章只做简略介绍)

  • 列表中应用区块援用

代码示例:

1. 有序列表 A
    > 援用区块
    1. 有序列表 Aa
        > 援用区块
    > 区块
2. 有序列表 B

示例成果:

  1. 有序列表 A

    援用区块

    1. 有序列表 Aa

      援用区块
      区块

  2. 有序列表 B
  • 区块援用中应用列表

代码示例:

> - 这序列表 A
> - 无序列表 B
>     * 子列表须要在 `>` 前面退出四个空格

示例成果:

  • 这序列表 A

  • 无序列表 B

    • 子列表须要在 > 前面退出四个空格

代码

倡议有输入内容的 Shell 命令前加上$, 不会把命令和输入的内容混同

  • 代码段

代码段能够应用一对反引号 \` \` 包裹住

代码示例:

文本段中应用 ` 代码段 `, 就用反引号包裹住

示例成果:

文本段中应用 代码段, 就用反引号包裹住

  • 代码区块

      - 每行文字前加 4 个空格
  - 每行文字前加 1 个 <kbd>tab</kbd> 键
  - 应用三个反引号 ``` 包裹一段代码，在第一个 ``` 前面能够指定代码语言，显示代码高亮，也能够不指定语言

应用三个引号包裹代码块，引号是放在最后方

代码示例:


    我是应用 4 个空格，造成的代码块
    我是应用一个 1 个 <kbd>tab</kbd> 键，造成的恶代码块

markdown 代码  
# 题目
1. 有序列表
```

___示例成果:___

---

    我是应用 4 个空格，造成的代码块
    我是应用一个 1 个 <kbd>tab</kbd> 键，造成的恶代码块

markdown 代码

题目

  1. 有序列表

    ---

## 链接

在 Markdown 中，链接能够应用到变量

  2. 简略链接

    • [链接名称](链接网址)
    • [链接名称](链接网址 "文字说明")
    • < 链接网址 >

    文字说明能够通过鼠标悬浮链接上查看

    代码示例:

    百度[百度](https://www.baidu.com/)
百度[百度](https://www.baidu.com/ "百度搜寻")
百度 <https://www.baidu.com/>

    示例成果:

    百度百度
    百度百度
    百度 https://www.baidu.com/

  3. 高级链接

    能够应用变量来调用链接

    应用变量要记得在文档的结尾为变量赋值

    代码示例:

    [百度][1]
[谷歌][2]

而后在文档的结尾为变量赋值（网址）


___示例成果:___

---

[百度][1]
[谷歌][2]

而后在文档的结尾为变量赋值（网址）[1]: https://www.baidu.com/
[2]: http://www.google.com/

---


## 图片

跟链接的办法区别在于后面加了个感叹号 ` ! `

* `[图片上传失败...(image-caa9b7-1632883183326)]`
* `[图片上传失败...(image-4d432f-1632883183327)]`
* ` 你也能够像链接一样应用变量[百度][1].`

而后在文档的结尾位变量赋值（网址）[1]: https://www.baidu.com/

__

___代码示例:___

![百度 logo]](https://www.baidu.com/img/PCt…)

百度

___示例成果:___

---

![百度 logo](https://upload-images.jianshu.io/upload_images/26609212-9378a73477b77248.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

![百度](https://upload-images.jianshu.io/upload_images/26609212-5240f8634959c454.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "百度 logo")

[百度][1]

[1]: https://www.baidu.com/

---

## 表格

在 Markdown 中 制作表格应用 | 来分隔不同的单元格，应用 - 来分隔表头和其余行。表格对齐放形式
* -: 设置内容和标题栏居右对齐。* :- 设置内容和标题栏居左对齐。* :-: 设置内容和标题栏居中对齐。_表格对齐都是写在表头上面一行的 `----` 中_

___代码示例:___
表头一 靠左对齐 居中对其 靠右对齐
单元格 1 单元格 2 单元格 3 单元格 4
单元格 11 单元格 22 单元格 33 单元格 44
单元格 111 单元格 222 单元格 333 单元格 444
单元格 1111 单元格 2222 单元格 3333 单元格 4444 
___示例成果:___

---

|  表头一   | 靠左对齐  |  居中对其  |   靠右对齐  |
| :----- | :-----| :----: | ----: |
| 单元格 1 | 单元格 2 | 单元格 3 | 单元格 4 |
| 单元格 11 | 单元格 22 | 单元格 33 | 单元格 44 |
| 单元格 111 | 单元格 222 | 单元格 333 | 单元格 444 |
| 单元格 1111 | 单元格 2222 | 单元格 3333 | 单元格 4444 |

---

## 目录

在须要目录呈现的中央（个别在文章一开始）搁置一个标记，这样会主动生成一个嵌套的蕴含所有题目的列表。_如果对应的各级题目中有空格 , 在锚点链接中用 `-` 代替空格_

___代码示例:___

本文目录示例

  • 题目

  • 文字

    • 粗斜体
    • 划线
    • 脚注

  • 段落

    • 换行
    • 分隔符

  • 列表

    • 无序列表
    • 有序列表
    • 列表嵌套

  • 区块援用

    • 简略区块援用
    • 区块援用的嵌套
    • 区块援用与列表
  • 代码
  • 链接
  • 图片
  • 表格
  • 目录

  • 高级技巧

    • 正文
    • 反对的 html 元素
    • 转义字符
    ___示例成果:___

---
  • 题目

  • 文字

    • 粗斜体
    • 划线
    • 脚注

  • 段落

    • 换行
    • 分隔符

  • 列表

    • 无序列表
    • 有序列表
    • 列表嵌套

  • 区块援用

    • 简略区块援用
    • 区块援用的嵌套
    • 区块援用与列表
  • 代码
  • 链接
  • 图片
  • 表格
  • 目录

  • 高级技巧

    • 正文
    • 反对的 html 元素
    • 转义字符

    高级技巧

    正文

    在 Markdown 中，正文能够自定义

  • 能够应用 html 语法正文<!-- 哈哈我是正文，不会在浏览器中显示。-->

  • 能够应用 *[·-·]: 正文内容 格局进行正文，其中 [] 中的内容能够自定义

    这些正文在代码段中有效，代码块中正文是依据所指定语言进行正文

    代码示例:

*5: 正文，不会显示
*[@_@]: 正文，不会显示


___示例成果:___

---

上面写了正文，但不会被解析渲染呈现，不同解析器反对的后果不同。<!-- 正文，不会显示 -->
[comment]: <> (正文，不会显示)
[//]: <> (正文，不会显示)
[//]: # (正文，不会显示)
*[^_^]: 正文，不会显示
*[@_@]: 正文，不会显示
 
---

#### 反对的 html 元素

目前反对的 HTML 元素有：`<kbd> <b> <i> <em> <sup> <sub> <br>` 等
_不在 Markdown 涵盖范畴之内的标签，都能够间接在文档外面用 HTML 撰写。_

___代码示例:___

tab键
粗体
斜体
也是斜体
文本 上标
文本 下标
换行
下一行

<details>

<summary> 点击查看 </summary>
这里是折叠的内容

</details>
还有很多其余 html 标签，这里就不一一列举了 …


___示例成果:___

---

<kbd>tab</kbd> 键
<b> 粗体 </b>
<i> 斜体 </i>
<em> 也是斜体 </em>
文本 <sup> 上标 </sup>
文本 <sub> 下标 </sub>
换行 <br> 下一行

<details>
    <summary> 点击查看 </summary>
    这里是折叠的内容
</details>
还有很多其余 html 标签，这里就不一一列举了...

---

#### 转义字符

在 Markdown 中应用了很多特殊符号，如果须要显示特定的符号则须要应用转义字符。能够应用反斜杠 `\` 来本义

___Markdown 反斜杠本义表___

| 转义字符 | 中文名称 |    英文名称 |
| :-----: | :-----:| :----: |
| \    | 反斜杠 | backslash    |
|`    | 反引号 | backtick    |
|*    | 星号 | asterisk |
|_    | 下划线 | underscore |
|{}    | 大括号 | curly braces |
|[]    | 方括号 | square brackets |
|()    | 括弧 | parentheses |
|#    | 井号 | hash mark |
|+    | 加号 | plus sign |
|-    | 减号（连字符）| minus sign (hyphen) |
|.    | 小数点 | dot |
|!    | 感叹号 | exclamation mark    |

___代码示例:___

\ 反斜线
\` 反引号
* 星号
\_ 下划线
{} 花括号
[] 方括号
() 小括号
\# 井字号
+ 加号
– 减号
. 英文句点
\! 感叹号

___示例成果:___

---

\\   反斜线
\`   反引号
\*   星号
\_   下划线
\{}  花括号
\[]  方括号
\()  小括号
\#   井字号
\+   加号
\-   减号
\.   英文句点
\!   感叹号
  1. 注脚名 ↩
  2. 我是脚注一，前面能够返回到加脚注地位的链接。↩
  3. 我是脚注二，前面能够返回到加脚注地位的链接。↩
  4. 我是脚注三，前面能够返回到加脚注地位的链接。↩
  5. _^ ↩
退出移动版