记录自己的Markdown学习过程

前言

说起来是为了记录上个arp欺骗实验过程📡才学习的markdown📚,后面做实验报告的时候也是尝试用Markdown来做,感觉效果挺不错的👍✅。完成之后一直都想以记录学习的形式整合复习一下📝,但还是拖到期末考之后📅⏳才弄,整个所有内容均参考菜鸟教程🌐,最后也是磨磨蹭蹭了三天😅🐢才彻底完工🎉✨。

目录

Markdown 标题

使用 # 号标记
Markdown使用#号来创建标题,使用#号可表示1~6级标题,一级标题对应一个#号, 依次增加。

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

重要注意事项:
符号与文字间的空格:# 号和标题文字之间必须有一个空格。这是标准的 Markdown 语法要求。

行首位置:#号必须在行首,前面不能有其他字符(空格或制表符)。

唯一的一级标题:在一个文档中通常只使用一个一级标题作为文档主标题。

Markdown 文本格式

字体

粗体语法: 使用两个星号 ** 或两个下划线 __ 包围文字:

  • 这是粗体文字

    这是**粗体文字** 使用星号

  • 这是 粗体文字

    这是 __粗体文字__ 使用下划线

(建议使用*,兼容性更强)

斜体语法: 使用一个星号 * 或一个下划线 _ 包围文字:

这是斜体文字 使用星号
这是 斜体文字 使用下划线

粗斜体组合: 使用三个星号 *** 或三个下划线 ___:

粗斜体文本
粗斜体文本


分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:

***
---
___


删除线

如果段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线 ~~ 即可

删除线
~~删除线~~


下划线

下划线可以通过 HTML 的 <u> 标签来实现:

这是下划线
<u>这是下划线<\u>


脚注

脚注是对文本的补充说明。
Markdown 脚注的格式如下:

[^要注明的文本]

创建脚注格式类似这样 ^RUNOOB


行内代码标记

行内代码用于在正文中标记代码片段、命令、变量名等:

基本语法:
使用一个反引号 ` 包围代码:

markdown
`markdown`

要显示反引号,使用`` `code` `` 这样的格式

`code`


文本高亮(扩展语法)

文本高亮不是标准 Markdown 语法,但许多扩展支持:
常见语法(部分平台支持):

这是==高亮文本==(vscode中安装markdown Preview Enhanced可查看)

HTML 替代方案:

这是<mark>高亮文本</mark>


段落和换行

在 Markdown 中,段落是文本的基本单位,理解段落规则对于正确格式化文档至关重要。

段落基本规则:

  • 段落由一个或多个连续的文本行组成
  • 段落之间由一个或多个空行分隔
  • 普通段落不应该用空格或制表符缩进

制换行技巧
有时需要在不创建新段落的情况下换行,Markdown 提供了几种方法:

方法一:行尾两个空格
在行尾添加两个或更多空格,然后按回车:

第一行内容(这里有两个空格)
第二行内容

方法二:HTML 换行标签

第一行内容<br>

第二行内容

方法三:反斜杠(部分解析器支持)

第一行内容\
第二行内容


Markdown 列表

无序列表

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

+ 第一项
+ 第二项
+ 第三项

- 第一项
- 第二项
- 第三项


有序列表

有序列表用于展示有顺序要求的步骤或项目。
有序列表使用数字并加上 . 号来表示,如:

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

列表嵌套

列表混合嵌套只需在子列表中的选项前面添加两个或四个空格即可:

  1. 第一项
    1. 第一项
    2. 第二项
  2. 第二项
    1. 第一项
    2. 第二项

(注意嵌套行标对应上层文字位置)

任务列表 (复选框列表)

基本语法

- [空格] 任务一
- [空格] 任务二
- [空格] 任务三

  • 任务一
  • 任务二
  • 任务三

(可通过添加空格分层)


Markdown 引用块

单级引用的使用

基本语法:
Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一个空格符号:

> 引用块


多级嵌套引用

> 最外层

>> 第一层嵌套

>>> 第二层嵌套

1

2

3


区块中使用列表

> 区块中使用列表
> 1. 第一项
> 2. 第二项
> - 第一项
> - 第二项

区块中使用列表

  1. 第一项
  2. 第二项
  • 第一项
  • 第二项

列表中使用区块

如果要在列表项目内放进区块,那么就需要在 > 前添加四个空格的缩进。

  • 第一项

    1
    2

  • 第二项

Markdowm 代码

行内代码

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

printf
`printf`


代码区块

缩进式代码块
代码区块使用 4 个空格或者一个制表符(Tab 键)
正常文本段落

这是缩进式代码块
每行前面有四个空格
保持代码的原始格式

继续正常文本

三反引号代码块
也可以用 ``` 包裹一段代码,并指定一种语言(也可以不指定):

```
111
222
333
```

在三反引号后添加语言标识符可以启用语法高亮功能。

1
2
3
4
5
6
7
8
9
```python{.line-numbers}=>显示行号
def calculate_area(radius):
"""计算圆的面积"""
import math
return math.pi * radius ** 2

# 使用函数
area = calculate_area(5)
print(f"圆的面积是: {area:.2f}")

```


Markdown 链接

链接使用方法如下:

[链接名称](链接地址)
[链接文字](链接地址 “可选的标题”)
<链接地址>


参考链接

[链接文字]/[参考标签]
/[参考标签]: URL “可选标题”

这个链接用 1 作为网址变量 Google

这个链接用 1 作为网址变量 [Google]/1
/1: http://www.google.com/

锚点链接的使用

锚点链接用于在同一文档内跳转,特别适合长文档的导航:
跳转到标题:

## 目录
- [第一章:介绍](#第一章介绍)
- [第二章:安装](#第二章安装)
- [第三章:使用方法](#第三章使用方法)
# 第一章:介绍
这里是介绍内容…
# 第二章:安装
这里是安装说明…
# 第三章:使用方法
这里是使用说明…


Markdown 图片

Markdown 图片语法格式如下:

![替代文字](图片路径)
![替代文字](图片路径 “图片标题”)

  • 开头一个感叹号 !
  • 接着一个方括号,里面放上图片的替代文字
  • 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的 ‘title’ 属性的文字

相对路径示例

![项目截图](./images/screenshot.png)
![用户界面](../assets/ui-demo.jpg “用户界面演示”)
![图标](images/icon.svg “应用图标”)

绝对路径示例

![本地图片](/Users/username/Documents/image.png)
![系统截图](C:\Users\username\Pictures\screenshot.png)

直接引用

![RUNOOB 图标](https://static.jyshare.com/images/runoob-logo.png)
![RUNOOB 图标](https://static.jyshare.com/images/runoob-logo.png “RUNOOB”)


Maekdown 表格

Maekdown制作表格使用|来分隔不同的单元格,使用-来分隔表头和其他行。
语法格式如下:

| 左对齐 | 右对齐 | 居中对齐 |
| :—-| —-: | :—: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

表头 表头 表头
单元格 单元格 单元格
单元格 单元格 单元格

Markdown 其他技巧

转义

Markdown使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown使用反斜杠转义特殊字符:

**文本加粗**
\ * \*正常显示星号\ * \ *

支持的HTML元素

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

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

使用<kdr>Ctrl</kdr>+<kdr>Alt</kdr>+<kdr>Del</kdr>重启电脑

使用 Ctrl+Alt+Del 重启电脑


Markdown 分割线

水平分割线的三种写法
Markdown支持三种方式创建水平分割线:

  1. 使用三个以上连字符
    ---
  2. 使用三个以上星号
    ***
  3. 使用三个以上下划线
    ___