markdown语法

星海的博客笔记

📝笔记名称：markdown语法  👨🏻作者：星海  🕰️创作日期：2024年7月23日

---

 

引言

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 XHTML（或者 HTML）。Markdown 的语法简洁明了，学习成本低，广泛用于撰写说明文档、GitHub 仓库的 README 文件、博客文章等。

以下是一些 Markdown 的基本语法示例：

---

 

1.布局

1.标题

# 这是 H1
## 这是 H2
### 这是 H3
#### 这是 H4
##### 这是 H5
###### 这是 H6

 

2.段落

>Markdown 段落由一行或多行文本组成，段落之间通过` `分隔。
 这是一个段落。
 这是另一个段落。

 

3.列表

1. 无序列表
   - 
   - 
   - 
2. 有序列表
   1.
   2.
   3.

 
4. 引用

引用

>     这是一个引用块。
> >   这是一个引用块
> > > 可以包含多行。

---

 

2.文字

1. 粗体和斜体

• 粗体：**粗体文本** 或 __粗体文本__
• 斜体：*斜体文本* 或 _斜体文本_
• 粗斜体：***粗斜体文本*** 或 ___粗斜体文本___
• 高亮：==高亮字体==

 
2.首行缩进

1.  半角的空格(一个英文大小)
2.  全角的空格(一个汉字大小)
 
3. 代码块

1. 单行注释

> 单行代码：使用反引号 `` 包裹
`这是一行代码`

 

2. 多行注释

> 多行代码（使用三个反引号 ```包裹，并可选地指定语言以启用语法高亮）
```python
# 这是一个 Python 代码块
print("Hello, World!")
```

 

3. 表格

Markdown中的表格使用|来分隔列，使用-（可选地，你可以在其中一侧或两侧添加:来指定对齐方式）来分隔表头和表体。

表头1	表头2	表头3
单元格1	单元格2	单元格3
单元格4	单元格5	单元格6

| 表头1 | 表头2 | 表头3 |
| :--: | :--: | :--: |
| 单元格1 | 单元格2 | 单元格3 |
| 单元格4 | 单元格5 | 单元格6 |

---

 

3.链接

1 .链接

点击会跳转到制定的链接地址

[这是一个链接](https://www.example.com)

 

2. 图片

插入一张图片，可以更好丰富笔记和理解

![图片描述](https://example.com/image.jpg)

 

3. 视频

视频可以更好的帮助我们理解

1. 页面直接插入一个网页，播放视频，他会自动播放，而且不能设置不自动播放

<div class="iframe-container" style="margin-left: 20px;">  
    <iframe  
        style="width: 100%; height: 600px; border: none; display: block;"  
        src="https://www.bilibili.com/video/BV1bK4y1i7BY/?spm_id_from=333.337.search-card.all.click&vd_source=4b2a3aa4c1475ef90a44549a323239ae"  
        allowfullscreen="true">  
    </iframe>  
</div>

2. 插入一段本地视频

Your browser does not support the video tag.

<video width="50%" height="" style="margin-left: 50px;" controls  >  
  <source src="movie.mp4" type="video/mp4">  
  Your browser does not support the video tag.  
</video>

 

注意：Markdown 的具体实现（如 GitHub Flavored 、Markdown、CommonMark、Obsidian 等）可能会有些许差异，但上述基本语法在大多数环境下都是通用的。