Markdown

简介

Markdown 是一种轻量级的标记语言，可用于在纯文本文档中添加格式化元素。Markdown 由 John Gruber 于 2004 年创建，如今已成为世界上最受欢迎的标记语言之一

1. 专注于文字内容；123

2. 纯文本，易读易写，可以方便地纳入版本控制；

3. 语法简单，没有什么学习成本，能轻松在码字的同时做出美观大方的排版。

基本使用

字体

1
*斜体文本*
2
_斜体文本_
3
**粗体文本**
4
__粗体文本__
5
***粗斜体文本***
6
___粗斜体文本___

斜体文本，快捷键 Ctrl I(此处只针对typora编辑器) 斜体文本 粗体文本，Ctrl B 粗体文本 粗斜体文本 粗斜体文本

分割线

——- Enter

​x
1
***
2

3
* * *
4

5
*****
6

7
- - -
8

9
----------

效果如下：

删除线

如果段落上的文字要添加删除线，只需要在文字的两端加上两个波浪线 ~~ 即可，实例如下：clb.pages.dev

xxxxxxxxxx
1
1
~~clb.pages.dev~~

下划线

下划线可以通过 HTML 的 <u> 标签来实现：带下划线文本

xxxxxxxxxx
1
1
<u>带下划线文本</u>

脚注

脚注是对文本的补充说明,鼠标悬浮后会显示内容,脚注一般放在文章最后

xxxxxxxxxx
3
1
我会使用[^markdown]
2

3
[^markdown]:Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档

我会使用¹

列表

Markdown 支持有序列表和无序列表

无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记，这些标记后面要添加一个空格，然后再填写内容：

xxxxxxxxxx
11
1
* 第一项
2
* 第二项
3
* 第三项
4

5
+ 第一项
6
+ 第二项
7
+ 第三项
8

9
1. one
10
2. two
11
3. three

• 第一项

• 第二项

• 第三项

1. one

2. two

3. three

嵌套使用

xxxxxxxxxx
4
1
- 1
2
  - 1.1
3
    - 1.1.1
4
      - 1.1.1.1

• 1

  • 1.1

    • 1.1.1

      • 1.1.1.1

引用

Markdown 引用是在段落开头使用 > 符号 ，然后后面紧跟一个空格符号：

xxxxxxxxxx
3
1
> 引用
2
> 123
3
> 456

引用 123 456

可嵌套

123

456

github风格警告框

xxxxxxxxxx
19
1
> [!NOTE]
2
>
3
> 提醒 `> [!note]`
4

5
> [!TIP]
6
>
7
> 建议 `> [!tip]`
8

9
> [!IMPORTANT]
10
>
11
> 重要 `[!important]`
12

13
> [!WARNING]
14
>
15
> 警告 `[!warning]`
16

17
> [!CAUTION]
18
>
19
> 注意 `[!caution]`

代码

如果是段落上的一个函数或片段的代码可以用反引号把它包起来（`），例如：print()

xxxxxxxxxx
1
1
`print()`

你也可以用 ``` 包裹一段代码，并指定一种语言（也可以不指定）：

xxxxxxxxxx
3
1
```python
2
print(666)
3
```

xxxxxxxxxx
1
1
print(666)

链接

链接使用方法如下：

xxxxxxxxxx
5
1
[链接名称](链接地址)
2

3
或者
4

5
<链接地址>

基本使用

我的主页

xxxxxxxxxx
1
1
[我的主页](https://clb.pages.dev)

直接使用链接

https://clb.pages.dev

xxxxxxxxxx
1
1
<https://clb.pages.dev>

高级链接

如果我的文档中很多地方都需要使用一个网址，可以将这个网址定义为一个变量放在文章末尾，其他需要使用这个网址的地方直接通过变量名访问

xxxxxxxxxx
7
1
这是我的[主页][home]
2

3
这也是我的[主页][home]
4

5
这还是我的[主页][home]
6

7
[home]:https://clb.pages.dev

效果如下：

这是我的主页

这也是我的主页

这还是我的主页

图片

Markdown 图片语法格式如下：

xxxxxxxxxx
4
1
![alt 属性文本](图片地址)
2
![alt 属性文本](图片地址 "鼠标悬浮时的提示文本")
3

4
![](https://s2.loli.net/2024/06/02/wuJknzxaFigDSdL.gif)

• 开头一个感叹号 !

• 接着一个方括号，里面放上图片的替代文字(可以省略)

• 接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上选择性的 '鼠标悬浮时的提示文本'(可以省略)

• 图片的链接也可以定义为变量后使用变量名使用

• 如果要改变图片大小，只能使用img标签设定相应属性

表格

制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行

基本使用

xxxxxxxxxx
4
1
|  表头   | 表头  |
2
|  ----  | ----  |
3
| 1  | 2|
4
| 3 | 4|

对齐方式

我们可以设置表格的对齐方式：

• -: 设置内容和标题栏居右对齐。

• :- 设置内容和标题栏居左对齐。

• :-: 设置内容和标题栏居中对齐。

实例如下：

xxxxxxxxxx
4
1
| 左对齐 | 右对齐 | 居中对齐 |
2
| :-----| ----: | :----: |
3
| 单元格 | 单元格 | 单元格 |
4
| 单元格 | 单元格 | 单元格 |

表格语法比较繁琐，建议使用编辑器插入表格功能

进阶

HTML 元素

不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写

目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等

在Markdown中，您可以使用多种HTML标签。行内元素，如<span>、<cite>、<del>，可以在Markdown的段落、列表或标题中自由使用。此外，您还可以使用<a>和<img>等标签来创建链接和图片。

对于块级元素，如<div>、<table>、<pre>和<p>，您需要在它们前后添加空行，并且不要使用制表符或空格进行缩进。请注意，在HTML块级标签内部，Markdown语法将不会被处理。例如，<p>italic and **bold**</p>将不会显示为斜体和粗体。

出于安全考虑，并非所有Markdown应用程序都支持在Markdown文档中添加HTML。如果您不确定您的应用程序支持哪些标签，请查看相应的手册或文档

这里有一个简单的例子，展示了如何在Markdown中混合使用HTML和Markdown语法：

xxxxxxxxxx
11
1
这是一个普通段落。
2

3
<span style="color: red;">这段文字将显示为红色。</span>
4

5
*这是Markdown格式的斜体*
6

7
<div>
8
这是一个HTML块级元素。
9
</div>
10

11
**这是Markdown格式的粗体**

以上Markdown代码将产生以下效果：

这是一个普通段落

这段文字将显示为红色。

这是Markdown格式的斜体

这是Markdown格式的粗体

任务列表

任务列表使您可以创建带有复选框的项目列表。在支持任务列表的Markdown应用程序中，复选框将显示在内容旁边。要创建任务列表，请在任务列表项之前添加破折号-和方括号[ ]，并在[ ]前面加上空格。要选择一个复选框，请在方括号[x]之间添加 x

xxxxxxxxxx
3
1
- [x] Write the press release
2
- [ ] Update the website
3
- [ ] Contact the media

• Write the press release

• Update the website

• Contact the media

Emoji 表情

有两种方法可以将表情符号添加到Markdown文件中：将表情符号复制并粘贴到Markdown格式的文本中，或者键入emoji shortcodes。

复制和粘贴表情符号

在大多数情况下，您可以简单地从Emojipedia 等来源复制表情符号并将其粘贴到文档中。许多Markdown应用程序会自动以Markdown格式的文本显示表情符号。从Markdown应用程序导出的HTML和PDF文件应显示表情符号

Tip: 如果您使用的是静态网站生成器，请确保将HTML页面编码为UTF-8

使用表情符号简码

一些Markdown应用程序允许您通过键入表情符号短代码来插入表情符号。这些以冒号开头和结尾，并包含表情符号的名称。

xxxxxxxxxx
2
1
多一眼看一眼就会:boom:
2
真好笑！ :joy:

多一眼看一眼就会💥 真好笑！ 😂

LaTex 数学公式

参考文章

行内使用$$包围 $a={\log }_{10}100$$a = \log_{10}100$

行间使用$$$$包围，也可以行内使用

• 分数: \frac {a} {b} $\frac{a}{b}$$\frac{a}{b}$

• 根号: \sqrt[3]{x^4} $\sqrt[3]{x^4}$$\sqrt[3]{x^4}$

• 点乘: a \cdot b $a\cdot b$$a \cdot b$​

• 叉乘: a \times b $a\times b$$a \times b$

• 上标: a^2 b^{1+2} $a^2$$a^2$ $b^{1+2}$$b^{1+2}$ 如果上标是表达式,则加{},下同

• 下标: a_i $a_6$$a_6$ $a_{1+3}$$a_{1+3}$

• 积分: \int_{a}^{b} ${\int }_a^b$$\int_{a}^{b}$

• 正弦: \sin{} $\sin x$$\sin{x}$

• 余弦: \cos{} $\cos (y+x)$$\cos{(y+x)}$

• 对数: \log_{6} ${\log }_{6}10$$\log_{6}10$​

• 大于号：(\textgreater) $\text{>}$$\textgreater$

• 小于号：(\textless)

• 大于等于：(\geq) $\ge$$\geq$

• 小于等于：(\leq) $\le$$\leq$​

IFrame标签

嵌入网页