MarkDown(.md)教程

FengMayou冯马佑 📋在职小初生

什么是 Markdown?

  • 一种轻量级标记语言
  • 通过纯文本编写结构化内容
  • 易读易写,可转换为 HTML/PDF 等格式
  • 广泛用于文档、笔记、博客、GitHub 等平台

基本语法

1. 标题

1
2
3
4
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
实例&效果

示例:

1
2
3
# 欢迎使用 Markdown
## 这是一个二级标题
### 这是一个三级标题

效果:

欢迎使用 Markdown

这是一个二级标题

这是一个三级标题


2. 段落与换行

  • 段落:直接换行文字
  • 强制换行:行尾添加两个空格
    或在段落间空一行
实例&效果

示例:

1
2
3
4
这是第一段文字。

这是第二段文字。
这是同一段内的换行。

效果:
这是第一段文字。

这是第二段文字。
这是同一段内的换行。


3. 列表

无序列表

1
2
3
- 项目1
- 项目2
- 子项目

有序列表

1
2
1. 第一项
2. 第二项
实例&效果

示例:

1
2
3
4
5
6
- 苹果
- 香蕉
- 黄香蕉
- 绿香蕉
1. 第一步
2. 第二步

效果:

  • 苹果

  • 香蕉

    • 黄香蕉
    • 绿香蕉
  1. 第一步
  2. 第二步

4. 强调与删除线

1
2
3
4
*斜体*_斜体_  
**粗体**__粗体__
***粗斜体***___粗斜体___
~~删除线~~
实例&效果

示例:

1
这是 *斜体*,这是 **粗体**,这是 ***粗斜体***,这是 ~~删除线~~。

效果:
这是 斜体,这是 粗体,这是 粗斜体,这是 删除线


5. 链接与图片

1
2
[链接文字](https://example.com)
![图片描述](image.jpg)
实例&效果

示例:

1
2
访问 [Google](https://www.google.com)。  
![Markdown Logo](https://markdown-here.com/img/icon256.png)

效果:
访问 Google
Markdown Logo


6. 代码

行内代码

1
使用 `print("Hello")` 语法

代码块

1
print("Hello World")
实例&效果

示例:

这是行内代码:print("Hello")

这是代码块:

1
2
def hello():
print("Hello World")

效果:
这是行内代码:print("Hello")

这是代码块:

1
2
def hello():
print("Hello World")

7. 表格

1
2
3
| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 内容1 | 内容2 | 内容3 |
实例&效果

示例:

1
2
3
4
| 姓名   | 年龄 | 职业     |
| :----- | :--: | --------: |
| 张三 | 25 | 工程师 |
| 李四 | 30 | 设计师 |

效果:

姓名 年龄 职业
张三 25 工程师
李四 30 设计师
| | |

8. 分割线

1
2
3
---

***

9. 引用

1
2
> 引用内容
>> 嵌套引用

高级语法

1. 任务列表

1
2
- [ ] 未完成
- [x] 已完成

2. 数学公式(需支持 LaTeX)

1
2
3
$$
E = mc^2
$$

3. 流程图(需特定解析器)

graph TD
A[开始] --> B{判断}
B -->|是| C[执行]
B -->|否| D[结束]

4. 脚注

1
2
3
这是一个脚注示例[^1]。

[^1]: 这里是脚注内容。

5. 折叠与提示块(部分平台支持)

1
2
3
4
5
6
<details>
<summary>点击展开</summary>

这里是折叠内容。

</details>
1
2
> [!NOTE]
> 这是一个提示块

总结

优势

  • 专注内容而非格式
  • 版本控制友好
  • 跨平台兼容

📝 适用场景

  • 技术文档
  • 笔记整理
  • 博客写作

提示:不同平台的 Markdown 解析器可能有差异,建议测试实际效果。


  • 标题: MarkDown(.md)教程
  • 作者: FengMayou冯马佑
  • 创建于 : 2025-03-09 10:48:00
  • 更新于 : 2025-09-28 23:25:19
  • 链接: https://blog.fengmayou.top/2025/03/09/makedown-firset/
  • 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。
评论